提取IP
选择提取类型
账户概况
登录查看当前账户余额,新用户可享新人福利
提取数量
IP使用时长
数据格式
选择属性
分隔符
选择地区
运营商
IP协议
使用说明
- * 生成API链接,调用GET请求即可返回所需的IP结果
- * 您的所有访问操作均有日志保存,望遵纪守法
- * 请使用合理的频率去调用API接口,暴力调用将导致您的客户端IP被防火墙封禁
使用说明
属性 | 内容 |
---|---|
URL | http://api.tianqiip.com/getip |
方法 | GET |
编码方式 | utf-8 |
参数说明 |
secret
:提取秘钥
num
(可选):提取IP数量,不能超过200,默认值10
yys
(可选):提取IP运营商,电信、移动、联通;
type
(可选):返回类型,txt,json;
lb
(可选):txt格式返回的分隔符
region
(可选):区域编号,多个用英文逗号分隔
port
:IP协议 1:HTTP 2:HTTPS 3:SOCKS5
time
(按次提取必选):IP使用时长只支持(3,5,10,15)
ts
(可选):是否显示IP过期时间, 1:显示 默认不显示
ys
(可选):是否显示IP运营商,1:显示 默认不显示
cs
(可选):是否显示位置,1:显示 默认不显示
|
异常 |
code
:错误的编号;
msg
:描述信息;
|
成功 |
返回内容的标签或字段类型可在产品管理里通过设置提取格式来定制;
类型为txt文本的定制标签如下:
ip:port自定义分隔符;
类型为json格式的响应字段如下:
data:[ { ip:IP port:端口 expire:有效时间 city:城市 isp:运营商 } ] |
状态码 |
1000:获取成功; 1001:请求格式不正确; 1002:单次请求数量超出最大值; 1003:请求KEY异常; 1004:套餐已过期; 1005:套餐提取数量上限; 1006:暂无可用IP; 1007:提取地区超出服务范围 |
返回结果示例
TEXT格式 |
---|
114.101.252.126:57577 |
114.101.252.126:57577 |
114.101.252.126:57577 |
JSON格式 |
---|
{
"code":200, "data":[ { "ip":"121.227.60.236" "port":"20252", "prov":"辽宁" "city":"鞍山" } { "ip":"121.227.60.236" "port":"20252", "prov":"辽宁" "city":"鞍山" } ] } |
白名单接口
属性 | 内容 |
---|---|
添加白名单接口 | http://api.tianqiip.com/white/add?key=xxx&brand=2&sign=xxx&ip=xxx |
删除白名单接口 | http://api.tianqiip.com/white/delete?key=xxx&brand=2&sign=xxx&ip=xxx |
查询白名单接口 | http://api.tianqiip.com/white/fetch?key=xxx&brand=2&sign=xxx |
方法 | GET |
编码方式 | utf-8 |
参数说明 |
key
:用户账号
sign
:密钥签名
ip
:需要添加或删除的ip地址, 多个使用','分割
brand
:固定参数, 固定取值 2
|
异常 |
{
code:
错误代码;
msg:
描述信息;
}
|
成功 |
{
code:
200
info:
描述信息
data:
[xxx ,xxx] // 仅查询接口返回此字段
} |
状态码 |
200:操作成功; 1001:参数有误; 1002:ip地址格式无效; 1003:key无效; 1004:参数sign错误; 1005:不是代理用户; 1006:添加的新ip数量超过最大数量限制; 1007:ip已存在 1008:ip地址不在服务范围 1009:白名单中不存在指定的ip可以删除 1101:服务器内部错误 |
通用
参数 | 说明 |
---|---|
407 | 白名单IP校验失败 |
431 | 代理认证口令为空 |
432 | 账号密码错误 |
直连IP
参数 | 说明 |
---|---|
430 | 客户端IP非国内 |
434 | 代理节点异常 |
435 | 代理IP状态异常 |
436 | 代理IP未经授权或已超出使用时长 |
转发
参数 | 说明 |
---|---|
451 | IP未提取或已过期 |
452 | 套餐信息异常 |
453 | IP提取记录不存在 |
454 | 套餐不存在 |
455 | 用户信息异常 |
456 | 未实名 |