Table of Contents
1. 文档说明
- 应用名称：Tieup
- API 版本：v1
- 基础路径：
/tieup/api/v1 - 适用端：粉丝端 APP、偶像端 APP、第三方回调
- 文档边界：不允许写入任何后台接口需求
- 数据标准：优先以
databases/selfbuilt/tieup_business.sql和databases/selfbuilt/tieup_config.sql为准，其次参考后端开发需求文档.md - 更新时间：2026-07-23
本文档用于指导服务端按 RESTful 规范设计接口。接口字段、状态值、业务单号、金额单位和关键约束必须与 SQL 保持一致；如果本文件与 SQL 冲突，以 SQL 为准。
接口测试状态摘要：
| 项目 | 结果 |
|---|---|
| 测试日期 | 2026-06-23 |
| 用户端路由 | 117 |
| 已安全探测 | 108/117 |
| 未直接调用 | 9/117 |
| 已知异常 | 无稳定异常 |
| 测试边界 | 本轮未造业务数据、未触发三方回调，不代表完整业务链路验收 |
接口进度状态：
| 状态 | 说明 |
|---|---|
待开发 |
接口或功能已定义，后端尚未确认完成 |
已开发 |
后端接口已实现并可自测 |
已开发，待测试 |
后端接口已实现并完成基础检查，等待联调或业务场景测试 |
基础探测通过，待数据联调 |
本轮已完成只读或低副作用 HTTP 探测，仍需真实数据和业务场景联调 |
未授权拦截通过，待登录态联调 |
本轮已验证未登录请求被认证中间件拦截，仍需登录态业务联调 |
参数校验通过，待业务联调 |
本轮已验证空参数请求被 FormRequest 或参数校验拦截，仍需有效参数业务联调 |
基础探测异常 |
本轮基础探测发现稳定异常，需修复后复测 |
未执行，需三方/真实联调 |
当前接口会触发外部依赖、回调日志或业务写入，需隔离测试数据或三方沙盒后执行 |
已对接 |
前端已完成联调并确认可用 |