创建 IP 列表
终点:
POSThttps://proxy-seller.com/personal/api/v1/{YourApiKey}/residentsubuser/list/add
路径参数:
名称 | 价值 | 说明 |
|---|---|---|
授权 |
| 您的个人应用程序接口密钥 |
请求正文:
名称 | 类型 | 说明 |
|---|---|---|
标题 | 字符串 | 您要创建的列表名称 |
白名单 | 字符串 | 用于授权的 IP。如果要使用登录凭据授权,则留空。 |
地理 | 反对 | 在列表中添加 GEO 数据(国家、地区、城市、ISP) |
国家 | 字符串 | 从全球环境展望数据库中选择的国家 |
地区 | 字符串 | 从全球环境展望数据库中选择的地区 |
城市 | 字符串 | 从 GEO 数据库中选取的城市 |
isp | 字符串 | 从全球环境展望数据库选取的 ISP |
出口 | 反对 | 在此,您可以指定列表中的 IP 数量和导出类型(端口号和文件格式)。 |
港口 | 数量 | IP 数量(最多 1000) |
绵延 | 字符串 | 出口类型 |
自转 | 数量 | "'-1'表示不旋转(粘滞),'0'表示按请求旋转,'1'至'3600'表示按时间旋转(秒)。 |
软件包密钥 | 字符串 | 要添加 IP 列表的子用户软件包的密钥 |
例如
https://proxy-seller.com/personal/api/v1/fj4948ffhg58gh843gh/residentsubuser/list/add回应:
{
"status": "success",
"data": {
"id": 561,
"title": "US Washington Garfield FIRST-STEP",
"login": "3c8aa1d4",
"password": "AZT62Dx3",
"whitelist": "127.0.0.1,192.168.0.1",
"rotation": "-1 = rotation, 0 = rotation per request, 1..60 time in seconds",
"geo": {
"country": "US",
"region": "Washington",
"city": "Garfield",
"isp": "FIRST-STEP"
},
"export": {
"ports": 10000,
"ext": "txt"
}
},
"errors": []
}{
"status": "error",
"data": null,
"errors": [
{
"message": "Error api key",
"code": 503,
"customData": null
},
{
"message": "IP not allowed",
"code": 503,
"customData": null
},
{
"message": "Request limit reached",
"code": 503,
"customData": null
}
]
}{
"status": "error",
"data": null,
"errors": [
{
"message": "IP not allowed",
"code": 503,
"customData": null
}
]
}{
"status": "error",
"data": null,
"errors": [
{
"message": "Tarif not found",
"code": 0,
"customData": null
}
]
}请求正文中包含错误的回复:
{
"status": "error",
"data": null,
"errors": [
{
"message": "Incorrect IP address 0.0.0.0 entered",
"code": 409,
"customData": null
},
{
"message": "Incorrect IP address 0.0.0.0 entered",
"code": 0,
"customData": null
}
]
}{
"status": "error",
"data": null,
"errors": [
{
"message": "IP 127.0.0.1 already linked",
"code": 0,
"customData": null
},
{
"message": "IP 127.0.0.1 already linked",
"code": "0",
"customData": null
}
]
}Same error may be in case with wrong "region", "city", "isp"!
{
"status": "error",
"data": null,
"errors": [
{
"message": "Invalid country (region, city, isp) ISO code",
"code": 400,
"customData": null
},
{
"message": "Invalid country ISO code (400)",
"code": 0,
"customData": null
}
]
}