獲取私密代理可用時長

1. 接口描述

https://dps.kdlapi.com/api/getdpsvalidtime 英文代號：get dps valid time

批量獲取私密代理IP的可用時長。目前私密代理按IP付費不支持此接口。
如果您在使用前不能確定某個私密代理ip還能使用多長時間，可以調(diào)用此接口獲取可用時長（單位：秒）。

必須使用訂單API密鑰調(diào)用本接口
接口最快調(diào)用頻率: 1秒10次

2. 參數(shù)說明

參數(shù)	是否必填	參數(shù)說明	取值說明
secret_id	是	訂單SecretId	查看訂單API密鑰信息
sign_type	否	簽名驗證方式。目前支持token和hmacsha1。	默認值：token
signature	是	請求簽名，用來驗證此次請求的合法性。	支持2種簽名驗證方式，簽名計算方法參見API 授權(quán)與驗證
timestamp	否	當前 UNIX 時間戳（秒級），可記錄發(fā)起 API 請求的時間。 sign_type=hmacsha1時此參數(shù)有效且為必填項。	例如1557546010，如果與當前時間相差過大，會引起簽名過期錯誤。
nonce	否	隨機正整數(shù)，與 timestamp 聯(lián)合起來，用于防止重放攻擊。建議攜帶此參數(shù)進一步提升API安全性。 sign_type=hmacsha1時此參數(shù)有效。	客戶自行生成隨機正整數(shù)，如random.randint(1, 100000000)
proxy	是	私密代理列表	格式：IP:PORT，多個代理用英文逗號分隔，例如： 113.120.61.166:22989 113.120.61.166:22989,122.4.44.132:21808

3. 調(diào)用示例

在會員中心API密鑰管理頁得到訂單的SecretId和SecretKey：

SecretId：o1fjh1re9o28876h7c08
SecretKey：jd1gzm6ant2u7pojhbtl0bam0xpzsm1c

以密鑰令牌驗證為例，調(diào)用獲取密鑰令牌接口得到密鑰令牌：

SecretToken：oxf0n0g59h7wcdyvz2uo68ph2s

調(diào)用示例

待驗證的代理IP：113.120.61.166:22989

GET https://dps.kdlapi.com/api/getdpsvalidtime?secret_id=o1fjh1re9o28876h7c08
&proxy=113.120.61.166:22989,122.4.44.132:21808
&signature=oxf0n0g59h7wcdyvz2uo68ph2s

使用說明

點擊查看關(guān)于API授權(quán)與驗證的介紹

4. 返回結(jié)果

接口返回json格式，樣例：

{
  "code": 0,
  "msg": "success",
  "data": {
    "122.4.44.132:21808": 856,
    "113.120.61.166:22989": 1135
  }
}

字段說明如下：

參數(shù)	說明
code	返回碼。取值：0代表成功非0代表失敗
msg	錯誤信息
data	字典格式，key: 代理ip（格式ip:port），value: 可用時長（單位：秒），樣例：{"122.4.44.132:21808": 856, "113.120.61.166:22989": 1135} 代表`122.4.44.132:21808`還能用856秒，`113.120.61.166:22989`還能用1135秒

5. 錯誤碼一覽

錯誤碼	說明
-1	缺少參數(shù)
-3	訂單類型錯誤，只支持私密代理訂單
-4	proxy參數(shù)格式錯誤
-5	暫不支持此訂單類型，目前僅私密代理按IP付費專業(yè)版不受支持

6. SDK

快代理提供了配套的開發(fā)工具集（SDK），支持多種編程語言，能更方便的調(diào)用 API。

SDK下載