栏目数据同步接口设计

栏目数据同步接口设计

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 响应。