提取IP

选择提取类型

账户概况

登录查看当前账户余额,新用户可享新人福利
提取数量
IP使用时长
  • 3分钟版 (5天启币/IP)
  • 5分钟版 (10天启币/IP)
  • 10分钟版 (20天启币/IP)
  • 15分钟版 (30天启币/IP)
数据格式
选择属性
分隔符
选择地区
运营商
IP协议
  • HTTP
  • HTTPS
  • SOCKS5
查看API文档

用户接入天启HTTP代码demo


Python语言

JavaScript语言

Java语言

Kotlin语言

Php语言

使用说明
  • * 生成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 未实名