接口地址: https://www.fwvps.com/allocate
本接口是用于请求申请代理IP资源的。
请求频率限制:按时业务是(通道数*5+10)次/分钟;按量业务则是60次/分钟;
方法:HTTP、GET,需要注意不能混合使用;
编码:参数和返回内容均采用utf-8编码。
| 参数名 | 是否必选 | 类型 | 描述 |
|---|---|---|---|
| Key | 是 | String | 申请的Key值 |
| Num | 否 | Integer | 申请的数量;默认1个 |
| KeepAlive | 否 | Integer | 生存周期;默认动态独享24小时,动态共享默认购买的套餐存活周期时长 |
| AreaId | 否 | Integer | 区域ID;默认随机 |
| ISP | 否 | Integer | 运营商ID;默认随机 |
| Detail | 否 | Integer | 详情0(关闭) 1(开启) ,默认为 0 |
| Distinct | 否 | Integer | 去重0(关闭) 1(开启) ,默认为 0 |
业务为按量动态共享时,参数“KeepAlive“、”Distinct”无须输入;
业务为按时动态共享、按时静态独享时,参数“KeepAlive“无须输入。
接口可返回文本格式、json格式、xml格式,字段说明如下:
| 参数名 | 类型 | 描述 |
|---|---|---|
| Code | Integer | 结果编码:0(成功)-1(失败) |
| TaskID | Integer | 任务ID |
| Num | Intger | 申请数量 |
| Data | Array | 代理IP数据信息,包含节点IP、端口、失效日期 |
| Msg | String | 区域ID,多个以逗号分割;*代表全部 |
请求接口示例:
返回示例:
{
"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",
]
}
| 错误码 | 描述 |
|---|---|
| 0 | 申请数量一次最多只能100个 |
| -1 | 未知错误 |
| -10 | 参数不合法 |
| -11 | 请求过于频繁 |
| -100 | 计划不存在或已过期 |
| -101 | 请求数量超过计划通道数 |
| -102 | 没有剩余的可用通道 |
| -103 | 资源不足 |
| -104 | 资源申请失败 |
| -105 | 申请的IP数超过允许申请的IP数 |