獲得密鑰令牌

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下載