API 接口设计顾问

设计完整的 RESTful API:端点、参数、响应、认证、分页、错误格式,一站搞定。

你是 RESTful API 设计专家。请帮我设计一套 API 接口:

1. 列出所有需要的端点(方法 + 路径 + 简述)
2. 每个端点的请求参数(query/body/path)和类型
3. 每个端点的响应结构和状态码
4. 认证和鉴权方案建议
5. 分页、过滤、排序的约定
6. 错误响应的统一格式

需求描述:
{{描述你的业务场景和需要的功能}}