获取私密代理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，支持按 省/市 筛选 仅支持按IP付费订单 |
多个地区用英文逗号分隔，如 成都,济南 (支持填写地区编码) |
| area_ex | 否 | 排除某些地区的ip，支持按 省/市 排除 仅支持按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 |
| f_carrier新 | 否 | 提取结果包含运营商信息 | 取值固定为1 |
| dedup | 否 | 过滤今天提取过的IP 不带此参数代表不过滤 |
取值固定为1 |
| format | 否 | 接口返回内容的格式 | text: 文本格式(默认) json: json格式 xml : xml格式 |
| sep | 否 | 提取结果列表中每个结果的分隔符 | 1: \r\n分隔(默认) 2: \n分隔 3: 空格分隔 4: |分隔 |
| carrier | 否 | 筛选ip运营商 此参数仅支持按IP付费订单 |
0: 不筛选(默认) 1: 联通 2: 电信 |
| whitelist | 否 | 是否开启IP白名单限制。 开启后只有您所设置的IP白名单内的IP才允许调用此接口 |
0: 不开启(默认) 1: 开启 |
3. 调用示例
在会员中心订单API接口页面得到订单号和API Key。
- 订单号：965102959536478
- apikey：
jd1gzm6ant2u7pojhbtl0bam0xpzsm1c
为演示简单，这里采用密钥明文验证生成签名参数，建议您在生产环境采用数字签名验证。
调用示例
提取10个私密代理IP
GET http://dps.kdlapi.com/api/getdps?orderid=965102959536478
&num=10
&signature=jd1gzm6ant2u7pojhbtl0bam0xpzsm1c
4. 返回结果
接口可返回文本格式、json格式、xml格式，字段说明如下：
| 参数 | 说明 |
|---|---|
| code | 返回码。取值：0代表成功 非0代表失败 |
| msg | 错误信息 |
| data | 包含接口返回的数据 |
| data.proxy_list | 返回的代理ip列表 |
| data.count | 返回的代理ip数量 |
| data.dedup_count | 返回的不重复的代理ip数量(按IP付费、包年包月集中提取订单专有) |
| data.order_left_count | 订单剩余提取余额(按IP付费订单专有) |
| 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>
<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>参数错误</msg>
<data>
</data>
</result>
5. 错误码一览
| 错误码 | 说明 |
|---|---|
| 2 | 订单已过期 |
| 3 | 暂无可用代理 |
| 4 | 账号尚未通过实名认证 |
| -1 | 无效请求 |
| -2 | 订单无效。如果刚下单，请耐心等待一会儿，3分钟内系统会自动发货。 |
| -3 | 参数错误 |
| -4 | 提取失败: $err_msg |
| -5 | 此订单不能提取私密代理 |
| -6 | 调用此接口的IP不在您设置的IP白名单内 |
| -51 | 此订单1分钟内允许最多$ip_number个ip调用 |
| -16 | 订单已退款 |
| -15 | 订单已过期 |
| -14 | 订单被封禁，请联系客服处理 |
| -13 | 订单已过期 |
| -12 | 订单无效 |
| -11 | 订单尚未支付 |
6. 生成API链接
您可以在线生成API链接，以便内置到您的程序或软件中。 生成API链接
7. SDK
快代理提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。
