接口文档 / 获取 AccessToken

获取 AccessToken

使用应用凭证获取门店访问令牌，不要求预先提供 AccessToken。连锁应用需提供子店 clinicId。

POST/api/v2/auth/token在线调试

请求参数

名称	说明	类型
Body 参数
`grantType`必填	授权方式枚举：`client_credentials`	`string`
`appId`必填	应用 ID 示例：`<APP_ID>`	`string`
`appSecret`必填	应用密钥，仅用于当前请求，不保存示例：`<APP_SECRET>`	`string`
`clinicId`可选	连锁应用必传，指定申请令牌的子店示例：`<CHILD_CLINIC_ID>`	`string`

json

{
  "grantType": "client_credentials",
  "appId": "<APP_ID>",
  "appSecret": "<APP_SECRET>",
  "clinicId": "<CHILD_CLINIC_ID>"
}

json

{
  "data": {
    "accessToken": "string",
    "tokenType": "string",
    "expiresIn": 0,
    "expirationTime": 0
  },
  "error": null
}

json

{
  "data": null,
  "error": {
    "code": 11003,
    "message": "不支持的授权类型{grantType}"
  }
}

按 环境 + appId + clinicId 分别缓存令牌。以响应中的 expiresIn、expirationTime 判断过期，预留合理的时钟偏差和请求时间；不要将有效期写死为两小时。

平台只在距离令牌失效 5 分钟内允许换取新 Token；不要在刚获取后重复申请。相同缓存键应合并并发申请，避免每次业务调用都重新申请 Token。

令牌已失效、被吊销或应用授权变化后，重新申请 Token，不要无限重试。

业务请求使用 authorization 请求头，同时提供 appId、ts 和 sign。authorization 的值为 AccessToken 原文，不加 Bearer 前缀。