快速开始
API 公共参数
API 涉及的公共请求参数和返回参数如下：
请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| Request-Id | string | 是 | 每次请求的唯一ID |
| Authorization | string | 否 | Bearer <token>，JWT token，除获取token接口外必填 |
| Content-Type | string | 是 | 固定值：application/json |
返回参数
所有返回均为 JSON 格式，数据结构如下：
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | string | 错误码，SUCCESS为成功 |
| message | string | 错误描述 |
| data | object | 业务数据 |
获取 Token
默认 token 有效期为 2 小时。token 过期后，可以重新获取新 token。
- 请求方法：POST
- 请求地址：/oauth/api/v1/token
请求参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| app_id | string | 开发者 app ID |
| app_secret | string | 开发者 app secret |
| grant_type | string | 固定值：client_credentials |
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| access_token | string | JWT token |
| expires_in | long | 过期时间（秒） |
| refresh_token | string | 刷新token（可选） |
| refresh_token_expires_in | long | 刷新token过期时间（秒） |