更换IP资源
1 接口描述
接口地址:https://proxy.qg.net/replace ;
本接口用于替换代理IP;
该接口单个Key的请求频率限制为:(通道数*5)+10 次/分钟;
方法:HTTP、GET,需要注意不能混合使用;
编码:参数和返回内容均采用utf-8编码。
2 输入参数说明
| 参数名 | 是否必选 | 类型 | 描述 |
|---|---|---|---|
| Key | 是 | String | 更换IP的Key值 |
| KeepAlive | 否 | Integer | 存活周期;默认动态独享24小时,动态共享默认购买的套餐存活周期时长 |
| AreaId | 否 | Integer | 区域ID;默认随机 |
| ISP | 否 | Integer | 运营商ID;默认随机 |
| Num | 否 | Integer | 申请数量,默认为全部 |
| Detail | 否 | Integer | 详情,0:关闭;1:开启;默认为0 |
| Distinct | 否 | Integer | 去重,0:关闭;1:开启;默认为0 |
| DataFormat | 否 | String | 数据格式,本接口取值:json、html、text ;默认为 json格式 |
| DataSeparator | 否 | String | 分隔符,自定义 |
3 返回值
接口可返回文本格式、json格式、xml格式,字段说明如下:
| 参数名 | 类型 | 描述 |
|---|---|---|
| Code | Integer | 结果编码,0:成功;-1:失败 |
| TaskID | Integer | 任务ID |
| Num | Intger | 申请数量 |
| Data | Array | 代理IP数据信息,包含节点IP、端口、失效日期 |
| Msg | String | 区域ID |
4 示例
请求接口示例:
curl "https://proxy.qg.net/replace?Key=请改成您的Key"
返回示例:
{
"Code": 0,
"TaskID": "91107E16D28AC5A",
"Num": "1",
"Data": [
{
"IP": "127.0.0.1",
"port": "49168",
"deadline": "2018-05-11 02:56:02",
"host": "127.0.0.1:49168"
}
]
}
5 接口返回错误码
| 错误码 | 描述 |
|---|---|
| -1 | 未知错误 |
| -10 | 参数不合法 |
| -11 | 请求过于频繁 |
| -12 | Authkey被封禁 |
| -13 | 当前客户端IP不在授权名单中 |
| -14 | Pwd不合法 |
| -15 | Authkey对应的业务无此权限 |
| -100 | 计划不存在或已过期 |
| -103 | 资源不足 |
| -104 | 申请资源失败 |
| -105 | 释放的IP数超过允许释放的IP数 |