檢測私密代理有效性

1. 接口描述

https://dps.kdlapi.com/api/checkdpsvalid 英文代號：check dps valid

批量檢測私密代理當前是否有效。目前私密代理按IP付費專業(yè)版不支持此接口。
理論上您提取的私密代理可用率不低于95%，但隨著時間的推移，ip可能失效。如果您在使用前不能確定某個私密代理ip是否有效，可以調(diào)用此接口檢測一下。

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

提示

我們的系統(tǒng)每分鐘都會對私密代理ip進行有效性檢測，確保這個接口返回的是我們1分鐘之內(nèi)的檢測結果。
系統(tǒng)是通過訪問百度首頁(m.baidu.com)來驗證代理的有效性。

2. 參數(shù)說明

參數(shù)	是否必填	參數(shù)說明	取值說明
secret_id	是	訂單SecretId	查看訂單API密鑰信息
sign_type	否	簽名驗證方式。目前支持token和hmacsha1。	默認值：token
signature	是	請求簽名，用來驗證此次請求的合法性。	支持2種簽名驗證方式，簽名計算方法參見API 授權與驗證
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, 123.163.183.200:18635

GET https://dps.kdlapi.com/api/checkdpsvalid?secret_id=o1fjh1re9o28876h7c08
&proxy=113.120.61.166:22989,123.163.183.200:18635
&signature=oxf0n0g59h7wcdyvz2uo68ph2s

使用說明

點擊查看關于API授權與驗證的介紹

4. 返回結果

接口返回json格式，樣例：

{
  "code": 0,
  "msg": "success",
  "data": {
    "122.4.44.132:21808": true,
    "113.120.61.166:22989": false
  }
}

字段說明如下：

參數(shù)	說明
code	返回碼。取值：0代表成功非0代表失敗
msg	錯誤信息
data	字典格式，key: 代理ip（格式ip:port），value: 是否有效（boolean型），樣例：{"122.4.44.132:21808": true, "113.120.61.166:22989": false}

5. 錯誤碼一覽

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

6. SDK

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

SDK下載