长效住宅代理 - 获取代理IP的API接口

站大爷官方 2024-01-15 4504 浏览

请使用合理的频率去调用API接口，暴力调用将导致您的客户端IP被防火墙封禁。

建议使用合理的频率按需调用，以及时获取更新的代理IP。

1 接口说明

属性	内容
URL	http://open.***.com/PrivateProxy/GetIP/
方法	`GET` `POST`
编码	`utf-8`
参数说明	`api`：实例ID； `akey`：实例的akey，由该实例的密码通过16位MD5加密得出； `count`：提取数量, 不能超过该实例的"单提限量"； `adr`(可选)：ip的地理位置筛选关键词，多关键词以半角逗号隔开，字符串使用UrlEncode编码； `fitter`：1表示"过滤今日已提取过的出口IP"，2表示不过滤； `timespan`：IP剩余存活时间，赋值范围为6-29，比如6，表示6-30分钟，注意选择最低存活时间越长，能提取到的IP可能越少； `tunnel`：IP集合类型，1表示"公网代理IP+反向代理IP"，2表示"仅包含公网代理IP"，3表示"仅包含反向代理IP（真人率与业务成功率极高）"；注意：由于反向代理IP不可预测生命周期，所以不受"IP剩余存活时间"条件约束，提取结果中也无法获取"剩余存活时间"； `type`：返回类型，1表示"Text文本"，2表示"XML"，3表示"JSON"。
响应	返回内容的标签或字段类型可在产品管理里通过设置提取格式来定制；类型为`Text文本`的定制标签如下： `{ip}`：ip地址； `{port}`：端口； `{adr}`：地理位置； `{outip}`：出口ip； `{timeout}`：预计剩余存活时间(秒)；若为反向代理IP，值固定为-1； `{cometime}`：上线时间(秒)。类型为`XML`或`JSON`格式的响应字段如下： `code`：错误编号； `msg`：描述信息； `data`：数据体； `count`：代理IP数量； `update_count`：本次提取过程中更新的不重复IP数量； `active_count`：近期提取历史里仍为存活状态的不重复IP数量； `today_count`：今日已提不重复IP数量； `surplus_count`：今日剩余可提不重复IP量（集中提取），剩余可提不重复IP量（按量付费）；均匀提取不返回该字段； `proxy_list`：代理IP列表； `ip`：ip地址； `port`：端口； `adr`：地理位置； `outip`：出口ip； `timeout`：预计剩余存活时间(秒)；若为反向代理IP，值固定为-1； `cometime`：上线时间(秒)。
错误编号	`10001`：获取成功； `12001`：akey错误； `12002`：调用频率过快； `12003`：参数不完整或有错误； `12004`：该实例不存在或已过期； `12005`：该实例已过期； `12006`：该实例已被冻结或禁用； `12007`：该实例当前授权模式为"终端IP授权"，但尚未绑定使用者终端IP； `12008`：该实例使用的HTTP连接次数额度已经超限(仅针对经典版产品)； `12009`：该参数条件下当前没有任何代理IP； `12010`：该实例今日集中提取的不重复的IP总量已经超限（集中提取），该实例累计提取到的不重复的IP总量已经超限（按量付费）。

2 接口示例

请求：

GET /PrivateProxy/GetIP/?api=1234567890&akey=8a17ca305f683620&count=5&fitter=2&timespan=6&tunnel=1&type=3 HTTP/1.1
Host: open.***.com

响应：

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Thu, 25 Apr 2019 10:48:42 GMT
Content-Length: 405

{
  "code": "10001",
  "msg": "获取成功",
  "data": {
    "count": 5,
    "proxy_list": [
      {
        "ip": "218.75.53.122",
        "port": 11756,
        "adr": "浙江省湖州市 电信",
        "outip": "218.75.53.122",
        "cometime": 49591,
        "timeout": 560
      },
      {
        "ip": "58.218.213.47",
        "port": 11214,
        "adr": "江苏省镇江市 联通",
        "outip": "122.194.25.181",
        "cometime": 1499,
        "timeout": -1
      },
      {
        "ip": "221.229.162.69",
        "port": 10146,
        "adr": "北京市 联通数据中心",
        "outip": "123.126.85.164",
        "cometime": 57223,
        "timeout": -1
      },
      {
        "ip": "121.232.9.187",
        "port": 11092,
        "adr": "江苏省南通市启东市 电信",
        "outip": "121.232.9.187",
        "cometime": 1201,
        "timeout": 783
      },
      {
        "ip": "58.218.213.44",
        "port": 10674,
        "adr": "广东省潮州市 电信",
        "outip": "113.107.217.13",
        "cometime": 23105,
        "timeout": -1
      }
    ]
  }
}