取消
最近搜索
清空历史

获得密钥令牌

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。

SDK下载

联系我们
  • 售前在线咨询
    咨询享免费测试,专业工程师提供技术支持
  • 客服热线
    400-058-0638  周一至周六 9:00-18:30
  • 提交工单
    您的每一次反馈我们都认真对待
  • 客服微信 & QQ
    客服微信:kuaidaili,客服QQ:800849628
  • 企业客户通道
    提交需求后专业的售前工程师为您提供服务