创建列表

最终目标：

POSThttps://proxy-seller.com/personal/api/v2/{YourApiKey}/resident/list/add

路径参数

名称	价值	描述
授权	`<Your_API_Key>`	您的个人 API 密钥

请求正文

名称	类型	描述
标题	字符串	您正在创建的列表名称
白名单	字符串	用于授权的IP地址。若需使用登录凭据进行授权，请留空。

geo	object	请在列表中添加地理位置数据（国家、地区、城市、互联网服务提供商）
国家	字符串	从GEO数据库中选定的国家（大小写区分很重要）
地区	字符串	从 GEO 数据库中选定的地区（区分大小写）
城市	字符串	从GEO数据库中选定的城市（区分大小写很重要）
isp	字符串	从GEO数据库中选定的ISP（大小写区分很重要）

export	object	在此处，请指定列表中的 IP 地址数量以及导出类型（端口号和文件格式）。
移植版	编号	IP条目数量（最多1000条）
ext	字符串	导出类型

技能循环	编号	“旋转：'-1' 表示不旋转（固定），'0' 表示按请求旋转，'1' 至 '3600' 表示以秒为单位的时间旋转

示例

https://proxy-seller.com/personal/api/v2/fj4948ffhg58gh843gh/resident/list/add
{
  "title": "myList",
  "whitelist": "",
  "geo": {
    "country": "AD",
    "region": "Andorra la Vella",
    "city": "Andorra la Vella",
    "isp": "Andorra Telecom, S.a.u."
  },
  "export": {
    "ports": 1,
    "ext": "csv"
  },
  "rotation": -1
}

{
    "status": "success",
    "data": {
        "id": 21829782,
        "title": "myList",
        "login": "123123",
        "password": "123123",
        "whitelist": "",
        "rotation": -1,
        "geo": [
            {
                "country": "AD",
                "region": "Andorra la Vella",
                "city": "Andorra la Vella",
                "isp": "Andorra Telecom, S.a.u."
            }
        ],
        "export": {
            "ports": "1",
            "ext": "csv"
        }
    },
    "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
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "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
        }
    ]
}

最终目标：

路径参数

请求正文

示例

回复

请求正文中包含错误的响应

On this page