获取私密代理IP¶
1. 接口描述¶
http://dps.kdlapi.com/api/getdps
实时批量获取私密代理IP列表。
- HTTP GET接口
- 参数和返回内容均采用utf-8编码
- 接口最快调用频率: 1秒10次
提示
所有私密代理IP都是五位随机端口、极速(响应时间<1秒)、高匿名、支持HTTP GET/POST/CONNECT方法、支持https、支持Socks5
2. 参数说明¶
参数 | 是否必填 | 参数说明 | 取值说明 |
---|---|---|---|
orderid | 是 | 订单号 | 有效的私密代理订单号。查看我的订单 |
sign_type | 否 | 签名验证方式。 | 默认值:normal |
signature | 否 | 请求签名,用来验证此次请求的合法性。 此接口默认不需要验证签名,但在会员中心开启验证后此参数则为必填项。 |
支持2种签名验证方式,签名计算方法参见API 授权与验证 |
num | 是 | 提取数量 | 例如:100 |
area | 否 | ip所在地区,支持按 省/市 筛选 仅支持计数版订单 |
多个地区用英文逗号分隔,如 北京,上海 |
pt | 否 | 提取的代理ip类型 | 1: http代理(默认) 2: socks代理 |
ut | 否 | 提取的代理ip可连续使用多长时间 根据您一个代理ip需要使用多久来选择筛选条件 |
0: 不筛选(默认) 1: 可用10分钟 2: 可用30分钟 3: 可用1小时 4: 可用2小时(计数版不支持) |
f_loc | 否 | 提取结果包含地区信息 | 取值固定为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 | 订单剩余提取余额(计数版专有) |
文本格式¶
正常返回代理列表,代理分隔符参见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. 生成API链接¶
您可以在线生成API链接,以便内置到您的程序或软件中。 生成API链接
5. 错误码一览¶
错误码 |
说明 |
---|---|
2 | 订单已过期 |
3 | 暂无可用代理 |
-1 | 无效请求 |
-2 | 订单无效。如果刚下单,请耐心等待一会儿,3分钟内系统会自动发货。 |
-3 | 参数错误 |
-4 | 提取失败: $err_msg |
-5 | 此订单不能提取私密代理。 |
-51 | 此订单1分钟内允许最多$ip_number个ip调用 |
-16 | 订单已退款 |
-15 | 订单已过期 |
-14 | 订单被封禁,请联系客服处理 |
-13 | 订单已过期 |
-12 | 订单无效 |
-11 | 订单尚未支付 |