archery-event-docs/09-后台API说明/字段级接口清单模板.md

字段级接口清单模板

1. 使用方式

后续每个接口都建议按以下格式补齐，补完后即可直接交给 agent 编写 Controller、DTO、Service 和测试。

2. 模板

接口名称

• 接口路径：
• 请求方法：
• 使用端：用户端 / 商户端 / 管理端
• 功能说明：
• 权限要求：

请求参数

字段	类型	必填	说明

返回字段

字段	类型	说明

错误码

code	场景	说明

备注

• 幂等要求：
• 状态变更：
• 日志要求：