获取私密代理IP
1. 接口描述
http://dps.kdlapi.com/api/getdps 英文代号:get dps
实时批量获取私密代理IP列表。
- HTTP GET接口
- 参数和返回内容均采用utf-8编码
- 接口最快调用频率: 1秒10次
- 接口IP白名单数量(同时允许调用此接口的IP数量)与购买的私密代理授权IP白名单数量相同
提示
所有私密代理IP都是五位随机端口、极速(响应时间<1秒)、高匿名、支持HTTP GET/POST/CONNECT方法、支持https、支持Socks5
2. 参数说明
参数 | 是否必填 | 参数说明 | 取值说明 |
---|---|---|---|
orderid | 是 | 订单号 | 有效的私密代理订单号。查看我的订单 |
sign_type | 否 | 签名验证方式。目前支持simple和hmacsha1。 | 默认值:simple |
signature | 否 | 请求签名,用来验证此次请求的合法性。 此接口默认不需要验证签名,但在会员中心开启验证后此参数则为必填项。 |
支持2种签名验证方式,签名计算方法参见API 授权与验证 |
timestamp | 否 | 当前 UNIX 时间戳(秒级),可记录发起 API 请求的时间。 sign_type=hmacsha1时此参数为必填项。 |
例如1557546010,如果与当前时间相差过大,会引起签名过期错误。 |
num | 是 | 提取数量 | 例如:100 |
area | 否 | 按地区筛选ip,支持按 省/市 筛选 仅支持按量付费订单 |
多个地区用英文逗号分隔,如 北京,上海 (支持填写地区编码) |
area_ex新 | 否 | 排除某些地区的ip,支持按 省/市 排除 仅支持按量付费订单 |
多个地区用英文逗号分隔,如 北京,上海 (支持填写地区编码) |
ipstart | 否 | 筛选以特定部分开头的IP (多个IP段用英文逗号分隔) |
比如: 120.52. |
ipstart_ex | 否 | 排除以特定部分开头的IP (多个IP段用英文逗号分隔) |
比如: 120.52. |
pt | 否 | 提取的代理ip类型 | 1: http代理(默认) 2: socks代理 |
st | 否 | 按稳定使用时长筛选ip 这个时长是从提取时算起可稳定使用的时间 此参数只对均匀提取30~60分钟版有效 |
0: 不筛选(默认) 其他值: 自定义时长(1-50分钟) |
f_loc | 否 | 提取结果包含地区信息 | 取值固定为1 |
f_citycode | 否 | 提取结果包含地区编码(参见地区编码表) | 取值固定为1 |
f_et | 否 | 提取结果包含此代理从提取时算起的可用时间(单位:秒) | 取值固定为1 |
dedup | 否 | 过滤今天提取过的IP 不带此参数代表不过滤 |
取值固定为1 |
format | 否 | 接口返回内容的格式 | text: 文本格式(默认) json: json格式 xml : xml格式 |
sep | 否 | 提取结果列表中每个结果的分隔符 | 1: \r\n分隔(默认) 2: \n分隔 3: 空格分隔 4: |分隔 |
3. 返回值
接口可返回文本格式、json格式、xml格式,字段说明如下:
参数 | 说明 |
---|---|
code | 返回码。取值:0代表成功 非0代表失败 |
msg | 错误信息 |
data | 包含接口返回的数据 |
data.proxy_list | 返回的代理ip列表 |
data.count | 返回的代理ip数量 |
data.dedup_count | 返回的不重复的代理ip数量(按量付费、包年包月集中提取订单专有) |
data.order_left_count | 订单剩余提取余额(按量付费订单专有) |
data.today_left_count | 今天剩余提取余额(包年包月集中提取订单专有) |
文本格式
正常返回代理列表,代理分隔符参见sep
参数,代理格式 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
异常返回错误码和错误提示,格式 ERROR(错误码): 错误提示
格式样例:
ERROR(-1): 参数错误
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": "参数错误", "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>
<proxylist>
<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>
</proxylist>
</data>
</result>
异常返回格式样例:
<?xml version="1.0" encoding="UTF-8"?>
<result>
<code>-1</code>
<msg>参数错误</msg>
<data>
</data>
</result>
4. 错误码一览
错误码 | 说明 |
---|---|
2 | 订单已过期 |
3 | 暂无可用代理 |
-1 | 无效请求 |
-2 | 订单无效。如果刚下单,请耐心等待一会儿,3分钟内系统会自动发货。 |
-3 | 参数错误 |
-4 | 提取失败: $err_msg |
-5 | 此订单不能提取私密代理。 |
-51 | 此订单1分钟内允许最多$ip_number个ip调用 |
-16 | 订单已退款 |
-15 | 订单已过期 |
-14 | 订单被封禁,请联系客服处理 |
-13 | 订单已过期 |
-12 | 订单无效 |
-11 | 订单尚未支付 |
5. 示例
订单号:965102959536478
以一次提取10个IP为例,不设置其他筛选条件
调用示例
将orderid=965102959536478
、num=10
用&
拼接起来作为参数即可生成API链接:
http://dps.kdlapi.com/api/getdps?orderid=965102959536478&num=10
返回示例
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
6. 生成API链接
您可以在线生成API链接,以便内置到您的程序或软件中。 生成API链接
7. SDK
快代理提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。