獲取私密代理IP
1. 接口描述
https://dps.kdlapi.com/api/getdps 英文代號(hào)：get dps
實(shí)時(shí)批量獲取私密代理IP列表。
- 必須使用訂單API密鑰調(diào)用本接口
- 接口最快調(diào)用頻率: 1秒10次
提示
所有私密代理IP都是五位隨機(jī)端口、極速（響應(yīng)時(shí)間<1秒）、高匿名、支持HTTP GET/POST/CONNECT方法、支持https、支持Socks5
2. 參數(shù)說明
| 參數(shù) | 是否必填 | 參數(shù)說明 | 取值說明 |
|---|---|---|---|
| secret_id | 是 | 訂單SecretId | 查看訂單API密鑰信息 |
| sign_type | 否 | 簽名驗(yàn)證方式。目前支持token和hmacsha1。 | 默認(rèn)值：token |
| signature | 是 | 請(qǐng)求簽名，用來驗(yàn)證此次請(qǐng)求的合法性。 此接口默認(rèn)需要驗(yàn)證簽名 |
支持2種簽名驗(yàn)證方式，簽名計(jì)算方法參見API 授權(quán)與驗(yàn)證 |
| timestamp | 否 | 當(dāng)前 UNIX 時(shí)間戳（秒級(jí)），可記錄發(fā)起 API 請(qǐng)求的時(shí)間。 sign_type=hmacsha1時(shí)此參數(shù)有效且為必填項(xiàng)。 |
例如1557546010，如果與當(dāng)前時(shí)間相差過大，會(huì)引起簽名過期錯(cuò)誤。 |
| nonce | 否 | 隨機(jī)正整數(shù)，與 timestamp 聯(lián)合起來，用于防止重放攻擊。建議攜帶此參數(shù)進(jìn)一步提升API安全性。 sign_type=hmacsha1時(shí)此參數(shù)有效。 |
客戶自行生成隨機(jī)正整數(shù)，如random.randint(1, 100000000) |
| num | 是 | 提取數(shù)量 | 例如：100 |
| area | 否 | 按地區(qū)篩選ip，支持按 省/市 篩選 僅支持按IP付費(fèi)訂單 |
多個(gè)地區(qū)用英文逗號(hào)分隔，如 成都,濟(jì)南 (支持填寫地區(qū)編碼) |
| area_ex | 否 | 排除某些地區(qū)的ip，支持按 省/市 排除 僅支持按IP付費(fèi)訂單 |
多個(gè)地區(qū)用英文逗號(hào)分隔，如 成都,濟(jì)南 (支持填寫地區(qū)編碼) |
| f_loc | 否 | 提取結(jié)果包含地區(qū)信息 | 取值固定為1 |
| f_citycode | 否 | 提取結(jié)果包含地區(qū)編碼（參見地區(qū)編碼表） | 取值固定為1 |
| f_et | 否 | 提取結(jié)果包含此代理從提取時(shí)算起的可用時(shí)間（單位：秒） | 取值固定為1 |
| f_carrier新 | 否 | 提取結(jié)果包含運(yùn)營(yíng)商信息 | 取值固定為1 |
| dedup | 否 | 過濾今天提取過的IP 不帶此參數(shù)代表不過濾 |
取值固定為1 |
| format | 否 | 接口返回內(nèi)容的格式 | text: 文本格式(默認(rèn)) json: json格式 xml : xml格式 |
| sep | 否 | 提取結(jié)果列表中每個(gè)結(jié)果的分隔符 | 1: \r\n分隔(默認(rèn)) 2: \n分隔 3: 空格分隔 4: \ |
| carrier | 否 | 篩選ip運(yùn)營(yíng)商 此參數(shù)僅支持按IP付費(fèi)訂單 |
0: 不篩選(默認(rèn)) 1: 聯(lián)通 2: 電信 3: 移動(dòng) |
3. 調(diào)用示例
在會(huì)員中心API密鑰管理頁得到訂單的SecretId和SecretKey：
- SecretId：
o1fjh1re9o28876h7c08 - SecretKey：
jd1gzm6ant2u7pojhbtl0bam0xpzsm1c
以密鑰令牌驗(yàn)證為例，調(diào)用獲取密鑰令牌接口得到密鑰令牌：
- SecretToken：
oxf0n0g59h7wcdyvz2uo68ph2s
調(diào)用示例
提取10個(gè)私密代理IP
GET https://dps.kdlapi.com/api/getdps?secret_id=o1fjh1re9o28876h7c08
&num=10
&signature=oxf0n0g59h7wcdyvz2uo68ph2s
使用說明
點(diǎn)擊查看關(guān)于API授權(quán)與驗(yàn)證的介紹
4. 返回結(jié)果
接口可返回文本格式、json格式、xml格式，字段說明如下：
| 參數(shù) | 說明 |
|---|---|
| code | 返回碼。取值：0代表成功 非0代表失敗 |
| msg | 錯(cuò)誤信息 |
| data | 包含接口返回的數(shù)據(jù) |
| data.proxy_list | 返回的代理ip列表 |
| data.count | 返回的代理ip數(shù)量 |
| data.dedup_count | 返回的不重復(fù)的代理ip數(shù)量(按IP付費(fèi)、包年包月集中提取訂單專有) |
| data.order_left_count | 訂單剩余提取余額(按IP付費(fèi)訂單專有) |
| data.today_left_count | 今天剩余提取余額(包年包月集中提取訂單專有) |
文本格式
正常返回代理列表，代理分隔符參見sep參數(shù)，代理格式 ip:port
格式樣例：
183.207.226.9:15867
120.197.85.171:23965
120.198.230.55:18923
120.198.230.112:21576
118.194.217.134:20523
183.232.29.132:18204
異常返回錯(cuò)誤碼和錯(cuò)誤提示，格式 ERROR(錯(cuò)誤碼): 錯(cuò)誤提示
格式樣例：
ERROR(-1): 參數(shù)錯(cuò)誤
json格式
正常返回格式樣例：
{
"msg": "",
"code": 0,
"data": {
"count": 10,
"dedup_count": 10,
"order_left_count": 990,
"proxy_list": [
"124.172.117.189:19812",
"219.133.31.120:26947",
"183.237.194.145:28436",
"183.62.172.50:23485",
"163.125.157.243:17503",
"183.57.42.79:26483",
"202.103.150.70:17251",
"182.254.129.124:15395",
"58.251.132.181:20659",
"112.95.241.76:21948"
]
}
}
異常返回格式樣例：
{"code": -1, "msg": "參數(shù)錯(cuò)誤", "data": ""}
xml格式
正常返回格式樣例：
<?xml version="1.0" encoding="UTF-8"?>
<result>
<code>0</code>
<msg/>
<data>
<count>10</count>
<dedup_count>10</dedup_count>
<order_left_count>990</order_left_count>
<proxy_list>
<proxy>124.172.117.189:19812</proxy>
<proxy>219.133.31.120:26947</proxy>
<proxy>183.237.194.145:28436</proxy>
<proxy>183.62.172.50:23485</proxy>
<proxy>163.125.157.243:17503</proxy>
<proxy>183.57.42.79:26483</proxy>
<proxy>202.103.150.70:17251</proxy>
<proxy>182.254.129.124:15395</proxy>
<proxy>58.251.132.181:20659</proxy>
<proxy>112.95.241.76:21948</proxy>
</proxy_list>
</data>
</result>
異常返回格式樣例：
<?xml version="1.0" encoding="UTF-8"?>
<result>
<code>-1</code>
<msg>參數(shù)錯(cuò)誤</msg>
<data>
</data>
</result>
5. 錯(cuò)誤碼一覽
| 錯(cuò)誤碼 | 說明 |
|---|---|
| 1 | 今日提取余額已用盡 |
| 2 | 訂單提取余額已用盡 |
| 3 | 沒有找到符合條件的代理 |
| 4 | 賬號(hào)尚未通過實(shí)名認(rèn)證 |
| -1 | 無效請(qǐng)求 |
| -2 | 訂單無效。如果剛下單，請(qǐng)耐心等待一會(huì)兒，1分鐘內(nèi)訂單會(huì)自動(dòng)生效。 |
| -3 | 參數(shù)錯(cuò)誤 |
| -4 | 提取失敗: $err_msg |
| -5 | 此訂單不能提取私密代理 |
| -6 | 調(diào)用此接口的IP不在您設(shè)置的IP白名單內(nèi) |
| -51 | 此訂單1分鐘內(nèi)允許最多$ip_number個(gè)ip調(diào)用 |
| -16 | 訂單已退款 |
| -15 | 訂單已過期 |
| -14 | 訂單被封禁，請(qǐng)聯(lián)系客服處理 |
| -13 | 訂單已過期 |
| -12 | 訂單無效 |
| -11 | 訂單尚未支付 |
6. 生成API鏈接
您可以在線生成API鏈接，以便內(nèi)置到您的程序或軟件中。 生成API鏈接
7. SDK
快代理提供了配套的開發(fā)工具集（SDK），支持多種編程語言，能更方便的調(diào)用 API。