注册
提取IP
API获取 提取接口 白名单接口 错误码
代码demo
Python语言 Go语言 C#语言 JavaScript语言 Java语言 Kotlin语言 Php语言 易语言
提取IP
  • 余额提取
查看API文档
使用说明

* 生成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:显示 默认不显示
    sign:用户签名，提取时必须添加
    mr: IP去重, 1:去重 默认选中去重
  • code: 错误编号
    Msg: 描述信息

  • 返回内容的标签或字段类型可在产品管理里通过设置提取格式来定制；
    类型为txt文本的定制标签如下：
    ip：port自定义分隔符；
    类型为json格式的响应字段如下：
    data：[
    {
    ip：IP
    port：端口
    expire：有效时间
    city：城市
    isp：运营商
    }
    ]

  • 1000: 获取成功
提取接口返回结果实例
TEXT格式
114.101.252.126.57577
114.101.252.126.57577
114.101.252.126.57577
JSON格式
{
"code": 1000,
"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&ip=xxx,xxx
  • GET
  • utf-8
  • Key: 用户账号
    Sign: 密钥签名
    ip: 需要添加或删除的ip地址,多个使用','分割
    brand: 固定参数,固定取值2
  • code: 错误编号
    Msg: 描述信息
  • code: 200
    info: 描述信息
  • 200: 操作成功
错误码
  • 错误码
  • 提取接口错误码
  • 白名单接口错误码
  • 代理使用错误码
  • 说明
  • 1001: 请求格式不正确
    1002: 单次请求数量超出最大值
    1003: 请求KEY异常
    1004: 套餐已过期
    1005: 套餐提取数量上限
    1006: 暂无可用IP
    1007: 提取地区超出服务范围
  • 1001: 参数有误
    1002: ip地址格式无效
    1003: 密钥或签名不正确
    1004: 参数sign错误
    1005: 不是代理用户
    1006: 添加的新ip数量超过最大数量限制
    1007: ip已存在
    1008: ip地址不在服务范围
    1009: 白名单中不存在指定的ip可以删除
    1101: 服务器内部错误
  • 407: 白名单IP校验失败
    430: 客户端IP非国内
    431: 代理认证口令为空
    432: 账号密码错误
    434: 代理节点异常
    435: 代理IP状态异常
    436: 代理IP未经授权或已超出使用时长
    451: IP未提取或已过期
    452: 套餐信息异常
    453: IP提取记录不存在
    454: 套餐不存在
    455: 用户信息异常
    456: 未实名
用户接入天启HTTP代码demo
Python语言
GO语言
C#语言
JavaScript语言
Java语言
Kotlin语言
Php语言
易语言