代理ip-http代理_高质量代理ip-星空代理-API提取

参数注释

示例：http://api1.xkdaili.com/tools/XApi.ashx?apikey=xxx&qty=1&format=txt&split=0&sign=xxx&area=440000

参数名称	含义	必填	使用说明
apikey	订单编号	是	套餐订单号对应的apikey
qty	提取数量	是	1-200
S5	IP协议类型	否	不填默认http/http 3：SOCKS5
format	数据格式	是	不填默认txt; Json
check	查询IP实时用量状态	否	check=1
fmt	显示运营商;IP时长	否	fmt=6
split	Txt格式分割符	是	默认为2 0:换行(\n) 1:回车(\r) 2:回车换行(\r\n)
sign	提取密钥	是	自动绑定分配sign
area	指定地区提取	否	440000:地区代码;更多详细地区代码可联系客服获取

返回结果实例
返回txt 格式：
27.153.5.211:22271
125.78.15.187:39121
返回json格式：{ "status":100 ,"info":"成功" , "data": [{"ip": "115.151.150.232", "port": "45012", "prov": "江西", "city": "新余"}

结果注释

status：状态码 info:状态提示信息 data：IP数据信息 IP：IP地址 port: ip端口 prov：省份 city：城市
usedNum：已使用数量 ipNum：IP总数

常见错误

状态码	说明	状态码	说明
201	请求格式不正确	302	API订单过期
202	秘钥验证失败	506	提取数量大于单次提取最大数
203	白名单个数限制	208	数量已用完
204	套餐已过期	205	套餐提取数量已达到上限
206	暂无可用IP	406	提取频率过快
207	提取机器超出服务范围	436	代理IP未经授权或已超出使用时长
211	添加白名单	432	账密错误
303	单次请求数量超出最大值	403	访问太频繁;列入黑名单
407	1.开始使用就出现- 需添加白名单 2.使用途中出现-IP时长已到	430	请使用国内地区白名单

1. 基础接口信息

请求地址：http://api10.xkdaili.com/ip

请求方式：GET

认证参数为 key（提取密钥，由平台根据帐号与订单生成；须完整复制本页「生成API链接」结果中的 key 值，勿自行拼接或修改）。

2. 请求参数说明

以下参数名为生成链接中的查询参数，与本页「提取链接」表单项一一对应。

参数名	是否必填	说明
key	必填	提取密钥（String）。
c	必填	提取 IP 数量（int），与本页「提取数量」一致；取值范围 1～200。
cty	选填	国家代码（String）。本页「全部地区」时为 00；「指定地区」时为所选国家代码。接口亦支持多个代码，英文逗号分隔。
ft	选填	数据格式（String），与本页「提取格式」一致：txt 或 json（小写）。
pt	选填	IP 协议（int）：1 HTTP/HTTPS、2 SOCKS5；与本页「IP协议」一致。
pat	选填	分隔符（String，URL 编码后写入链接）。仅 `ft=txt` 时有效；与本页「分隔符」对应：`\n`、`\r`、`\r\n`、`\t`。
rep	选填	IP 去重（int）：本页「去重」为 1、「不去重」为 0。
ts	选填	IP 时效，单位分钟（int，正整数）。本页选「指定IP时效」时写入，范围为 1～120；选「每次请求更换IP」时不传该参数。

3. 返回示例（JSON）

成功且 ft=json 时的典型结构：

返回信息

{
 "code": 0,
 "success": true,
 "msg": "0",
 "data": [
    { "ip": "47.244.192.12", "port": 16098 },
    { "ip": "47.244.192.12", "port": 15698 }
  ]
}

返回字段说明（成功 JSON）

字段名	说明
`code`	返回结果（String）；成功时为 `0`。
`success`	是否成功（Boolean）。
`msg`	返回信息（String）；失败时包含错误描述。
`data`	代理列表数组；每项一条代理记录。
`data[].ip`	IP 地址（String）。
`data[].port`	端口号（int）。

4. 返回示例（TXT）

成功且 ft=txt 时，每行一般为一条 ip:port；具体换行由链接中的 pat 决定。

47.244.192.12:16098
47.244.192.12:15698

5. 状态码说明

状态码	描述
200	操作成功
201	请求格式不正确
202	套餐信息异常
203	用户信息异常
204	用户未认证
205	白名单 IP 异常 / ip(xxx) 未添加到白名单
206	暂无可用 IP
207	端口不足
208	客户端 IP 不在允许的服务范围

失败时 success 为 false，code 与 msg 见上表；请以实际响应为准。

1. 基础信息

代理地址：proxy.xkdaili.com:31212

协议类型：HTTP / HTTPS / SOCKS5（按客户端支持选择）。

认证方式：用户名 + 密码。用户名由固定前缀 customer- 与认证帐号及可选参数拼接而成；密码为平台分配的隧道密码（与本页「选择认证账号」对应，勿自行修改）。

在用户名后使用英文连字符 - 追加下列参数段，完整格式为 customer-{帐号}[-country-{国家}][-region-{地区}][-session-{会话ID}-time-{分钟}]，再与密码以 用户名:密码 传入代理认证。

2. 用户名参数说明

参数名	是否必填	说明
customer	必填	认证帐号段。固定为 `customer-{您的隧道帐号}`，其中 `{您的隧道帐号}` 由本页「选择认证账号」展示，须完整使用。
country	选填	国家（String）。不追加时表示全球混播；指定时为国家代码，使用大写英文缩写（如 US、GB），写法为 `-country-US`。
session	选填	粘性会话 ID（String）。用于在一段时间内保持出口 IP 不变；须与 `time` 成对出现，且写在 `time` 之前。本页生成器每次生成 8 位字母数字；自行调用时可自定义（建议 8～16 位字母数字）。写法为 `-session-abc12def`。
time	选填	粘性 IP 保持时长，单位分钟（int）。仅在与 `session` 同时使用时有效；取值范围 3～30，与本页「粘性」会话时长一致；须写在 `session` 之后。写法为 `-time-10`。

未追加 time / session 时即为轮换模式，每次请求可更换出口 IP（与本页「轮换」一致）。

3. 调用示例（curl）

以下示例中 xxxx 为隧道密码，xxx 为认证帐号；代理主机为 proxy.xkdaili.com :31212。

全球混播（默认）

curl -x proxy.xkdaili.com:31212 -U "customer-xxx:xxxx" ipinfo.io

指定国家

curl -x proxy.xkdaili.com:31212 -U "customer-xxx-country-US:xxxx" ipinfo.io

粘性 IP（保持出口不变）

curl -x proxy.xkdaili.com:31212 -U "customer-xxx-session-abcdefgh-time-10:xxxx" ipinfo.io

可将 time 设为 3、10、30 等（3～30 分钟内）；同一 session 值在时长内尽量保持相同出口 IP。

组合：国家 + 粘性

curl -x proxy.xkdaili.com:31212 -U "customer-xxx-country-US-session-abcdefgh-time-3:xxxx" ipinfo.io

4. 代理连接串格式

本页「生成」支持以下四种文本格式（与表单「生成方式」一致）：

username:password@proxy.xkdaili.com :31212
proxy.xkdaili.com :31212@username:password
username:password:proxy.xkdaili.com :31212
proxy.xkdaili.com :31212:username:password

其中 username 为上文拼接后的完整用户名，password 为隧道密码，hostname:port 为代理地址 proxy.xkdaili.com :31212。