栏目数据同步接口设计
Endpoint:
POST /api/categories/sync
请求头 (Request Headers):
- Content-Type: application/json
- Authorization: Bearer {访问令牌}
请求体 (Request Body):
{
"categories": [
{
"id": "cat_123",
"name": "News",
"description": "Latest news updates",
"parent_id": null
},
{
"id": "cat_456",
"name": "Opinion",
"description": "Opinions and editorials",
"parent_id": null
},
{
"id": "cat_789",
"name": "Technology",
"description": "Tech-related articles",
"parent_id": "cat_123"
}
// 更多栏目数据...
]
}
响应 (Response):
{
"success": true,
"message": "栏目数据成功同步",
"errors": []
}
说明:
- Endpoint:
/api/categories/sync
是栏目数据同步的接口路径。
- 请求头: 包含了请求的内容类型和授权信息,以Bearer Token形式进行身份验证。
- 请求体: 栏目数据以JSON格式发送,每个栏目由ID、名称、描述、父级栏目ID等信息组成。
- 响应: 返回一个包含成功与否信息、消息和错误列表的 JSON 响应。