集成与对接

API 基础信息

{
  "method": "GET",
  "url": "https://api.1001n.net/v1/qx/knowledge/categories",
  "headers": {
    "X-Tenant-Id": "your-tenant-id",
    "X-Qx-Role": "PARENT",
    "X-Qx-User-Id": "your-user-id"
  }
}
          

X-Tenant-Id + 角色头认证

所有 API 请求都需要在请求头中包含租户 ID 和角色信息，以确保请求的安全性和权限控制。

• X-Tenant-Id：租户 ID，用于标识不同的租户
• X-Qx-Role：角色类型，可选值：PARENT、COACH、ADMIN
• X-Qx-User-Id：用户 ID，用于标识具体的用户

请求头示例

// 家长角色示例
{
  "X-Tenant-Id": "your-tenant-id",
  "X-Qx-Role": "PARENT",
  "X-Qx-User-Id": "your-user-id"
}

// 教练角色示例
{
  "X-Tenant-Id": "your-tenant-id",
  "X-Qx-Role": "COACH",
  "X-Qx-User-Id": "your-coach-id"
}

// 管理员角色示例
{
  "X-Tenant-Id": "your-tenant-id",
  "X-Qx-Role": "ADMIN",
  "X-Qx-User-Id": "your-admin-id"
}