接口格式与授权
最后更新于 2023/09/07 阅读数 102
接口返回值均为 JSON 格式, 包含三个字段: "code", "data", "message"
Field | Type | Description |
---|---|---|
code | int | 状态码(status code), 为 0 时表示返回值正常, 其他任何值时均表示异常 |
message | string | 提示信息 |
data | dict | 返回的数据。详情见下面具体接口. 当一个接口仅需状态码确认时, data 可以为空 |
API授权
通过token的方式提供API授权,联系仟寻平台,获取相关的app_key,app_secret
根据仟寻提供的 app_key 和 app_secret 生成token令牌,访问其他 api 时需要携带令牌.
Token
Method:POST
Path:/authorizations/token
Body Parameters
Key | Required | Type | Description |
---|---|---|---|
app_key | Yes | string | 公司唯一标识 |
app_secret | Yes | string | 秘钥 |
Response data
Key | Describe |
---|---|
token | 令牌 |
expire | 有效时间(小时) |
Request
{
"app_key":"*****",
"app_secret":"*****"
}
1
2
3
4
5
plaintext2
3
4
5
Response
{
"code": 0,
"message": "",
"data": {
"token": "*****",
"expire": 24
}
}
1
2
3
4
5
6
7
8
plaintext2
3
4
5
6
7
8
评价这篇文档
有帮助
没帮助