获得密钥令牌
1. 接口描述
https://auth.kdlapi.com/api/get_secret_token 英文代号：get secret token
通过API密钥获得接口验证所需的令牌。
- 当前令牌没失效之前调用本接口仍返回当前令牌
- 调用本接口时如果当前令牌还剩5分钟到期，会生成并返回新的令牌，旧令牌仍会自然到期失效
- 令牌默认有效期为60分钟，您可在API设置页更改
- 本接口只支持HTTP POST请求
- 接口最快调用频率: 1秒1次
安全提示
因secret_key在网络中频繁传输会增加泄露风险，故不建议频繁调用此接口。
建议您获得secret_token后本地存储，减少调用频率。
可调用检测密钥令牌接口实时检测secret_token的剩余有效时长。
2. 参数说明
| 参数 | 是否必填 | 参数说明 | 取值说明 |
|---|---|---|---|
| secret_id | 是 | 订单或账户SecretId | 查看API密钥信息 |
| secret_key | 是 | 订单或账户SecretKey | 查看API密钥信息 |
3. 调用示例
在会员中心API密钥管理页得到订单或账户的SecretId和SecretKey：
- SecretId：
o1fjh1re9o28876h7c08 - SecretKey：
jd1gzm6ant2u7pojhbtl0bam0xpzsm1c
调用示例
POST https://auth.kdlapi.com/api/get_secret_token HTTP/1.1
Content-Type: application/x-www-form-urlencoded
secret_id=o1fjh1re9o28876h7c08&secret_key=jd1gzm6ant2u7pojhbtl0bam0xpzsm1c
使用说明
点击查看关于API授权与验证的介绍
4. 返回结果
接口返回json格式，样例：
{
"code": 0,
"msg": "success",
"data": {
"secret_token": "oxf0n0g59h7wcdyvz2uo68ph2s",
"expire": 3600
}
}
字段说明如下：
| 参数 | 说明 |
|---|---|
| code | 返回码。取值：0代表成功 非0代表失败 |
| msg | 错误信息 |
| data.secret_token | 密钥令牌 |
| data.expire | 密钥令牌的有效期，即距离过期的剩余时长（单位：秒） |
5. 错误码一览
| 错误码 | 说明 |
|---|---|
| -1 | 缺少参数 |
| -2 | secret_id / secret_key参数错误 |
6. SDK
快代理提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。