代理操作

管理代理订单中的IP地址——列出、轮换、延长或添加注释。

通用参数。本页面上的每个端点均按特定顺序运行。传递 orderNumber — 从GET /proxy/list.

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/list

返回按类型分组的活跃代理。

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/list/{type}

返回一种类型的活跃代理。支持与 /proxy/list 相同的查询参数

路径参数

名称

价值

必填

描述

类型

ipv4,ipv6,mobile,isp,mix,mix_isp，或resident

是

指定要包含在下载列表中的代理类型。

授权

<Your_API_Key>

是

您的个人 API 密钥（如何获取)

查询参数

名称	类型	必填	描述
最新	字符串	否	`Y`返回来自最新活跃订单的代理，当`orderId` 未提供。
orderId	字符串	否	根据特定的 orderId 或 OrderPart.number 返回一个代理对象
国家	字符串	否	Alpha3 国家名称（FRA 或 DEU 等……）
结束	字符串	否	`Y` 仅返回`ENDED` 仍保留的代理服务器`dateEnd` 将来。否则，封闭式代理将被排除在外。

示例

要检索所有类型的代理：

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/list

要检索特定类型的代理（例如 IPv4）：

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/list/ipv4

各类代理

{
  "status": "success",
  "data": {
    "ipv4": [],
    "ipv6": [],
    "mobile": [],
    "isp": [],
    "mix": [],
    "mix_isp": [],
    "resident": []
  },
  "errors": []
}

一种代理类型

{
    "status": "success",
    "data": {
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_UUf2Z3RtGH",
                "basket_id": "69fa4b7a5a1f522c7a53d58b",
                "ip": "11.55.11.0",
                "ip_only": "11.55.11.0",
                "protocol": "HTTP",
                "port_socks": 49453,
                "port_http": 49353,
                "login": "login",
                "password": "password",
                "authIp": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Germany",
                "country_alpha3": "DEU",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "05.05.2026",
                "date_end": "11.06.2026",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": ""
            }
        ]
    },
    "errors": []
}

代理类型错误

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Could not find description of list/{type} in CrmUserApiProxy",
            "code": 22002,
            "customData": null
        }
    ]
}

请注意，如果未指定代理类型，系统将返回您配置文件中所有可用的代理类型。

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/download/{type}

导出IP地址

此 API 端点允许您下载您的代理列表。

路径参数：

名称	价值	必填	描述
类型	`ipv4`,`ipv6`,`mobile`,`isp`,`mix`,`mix_isp`，或`resident`	是	指定要包含在下载列表中的代理类型。
授权	`<Your_API_Key>`	是	您的个人 API 密钥（如何获取)

可选参数

名称	价值	描述
ext	txt csv	指定下载代理列表的格式。
	%login%:%password%@%ip%:%port%	自定义格式
proto	https socks5	指定您希望代理服务器采用的代理端口格式。
listId	整数	代理列表 ID（仅限常驻用户，若未设置，将返回所有数据表中的 IP 地址）
package_key	字符串	代理列表 package_key（仅限非常驻用户）
国家	字符串	Alpha3 国家名称（FRA 或 USA 或 ...）
结束	字符串	`Y` - 结尾代词列表

示例

要检索特定类型的代理（例如 IPv4）：

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/download/ipv4?ext=txt&proto=https

响应：代理类型错误

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Could not find description of list{type} in CrmUserApiProxy",
            "code": 22002,
            "customData": null
        }
    ]
}

修改

POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/replace

替换 IP 地址

轮换 IP 地址时，请勿丢失顺序槽位。此操作将计入每月替换配额。

路径参数

名称	价值	必填	描述
授权	`<Your_API_Key>`	是	您的个人 API 密钥（如何获取)

请求正文

名称	类型	描述
ids	编号	单个ID或用逗号分隔、用“[ ]”括起的ID数组
评论	字符串	可选说明（随请求一并提供）
类型	字符串	替换类型

示例

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/replace
{
    "ids": ["10"],
    "type": "CUSTOM",
    "comment": "Test replace IP"
}

{
    "status": "success",
    "data": {
        "ok": {
            "ips": [
                "11.55.11.0"
            ],
            "msg": "Replacement request submitted"
        }
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 503,
            "message": "Error api key",
            "customData": null
        },
        {
            "code": 503,
            "message": "IP not allowed",
            "customData": null
        },
        {
            "code": 503,
            "message": "Request limit reached",
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "Set coorect type: NOT_WORK / INCORRECT_LOCATION / CANT_CHANGE_NETWORK / LOW_SPEED / CUSTOM",
            "customData": null
        }
    ]
}

替换类型：NOT_WORK、INCORRECT_LOCATION、CANT_CHANGE_NETWORK、LOW_SPEED、CUSTOM

POST https://proxy-seller.com/personal/api/v2/{apiKey}/prolong/calc/{type}

延长 IP 地址

延长选定 IP 的有效期。按 IP-天计费。

本文档详细介绍了如何为各类IP地址设置自动续期。请注意，必须按时续期IP地址，才能保留原有的地址。

计算扩展名

此端点可帮助您计算费用。批量折扣和租赁期限折扣与我们服务提供的优惠类似。

路径参数

名称

价值

必填

描述

授权

<Your_API_Key>

是

您的个人 API 密钥（如何获取)

类型

ipv4

ipv6

mobile

isp

mix

mix_isp

是

您要扩展的代理类型

请求正文

名称	类型	描述
ids	编号	单个 ID 或用逗号分隔、用 '[ ]' 括起的 ID 数组（获取方法）
优惠券	字符串	您要添加的评论
periodId	字符串	您在 /reference/list/{type} 请求中选定的时段的 ID

示例（例如 ipv4）

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/prolong/calc/ipv4
{
    "ids": ["10"],
    "periodId": "1m",
    "coupon": "",
    "paymentId": "balance"
}

{
    "status": "success",
    "data": {
        "warning": "",
        "balance": 498648.72,
        "total": 3.49,
        "quantity": 1,
        "currency": "USD",
        "discount": 3.00,
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_UUf2Z3RtGH",
                "basket_id": "69fa4b7a5a1f522c7a53d58b",
                "ip": "11.55.11.0",
                "ip_only": "11.55.11.0",
                "protocol": "HTTP",
                "port_socks": 49453,
                "port_http": 49353,
                "login": "login ",
                "password": "password",
                "authIp": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Germany",
                "country_alpha3": "DEU",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "05.05.2026",
                "date_end": "11.06.2026",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": ""
            }
        ],
        "orders": 1
    },
    "errors": []
}

{
    "status": "error",
    "data": {
        "warning": "Insufficient funds. Total $3.49. Not enough $2.49",
        "balance": 1.00,
        "total": 3.49,
        "quantity": 1,
        "currency": "USD",
        "discount": 3.00,
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_UUf2Z3RtGH",
                "basket_id": "69fa4b7a5a1f522c7a53d58b",
                "ip": "11.55.11.0",
                "ip_only": "11.55.11.0",
                "protocol": "HTTP",
                "port_socks": 49453,
                "port_http": 49353,
                "login": "login",
                "password": "password",
                "authIp": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Germany",
                "country_alpha3": "DEU",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "05.05.2026",
                "date_end": "11.06.2026",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": ""
            }
        ],
        "orders": 1
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "Set existed [periodId] from reference",
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "IP not found",
            "customData": null
        }
    ]
}

POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/prolong/make/{type}

延长 IP 地址

在本节中，您将学习如何创建续订订单。

创建续订订单

创建扩展订单。

路径参数

名称

价值

必填

描述

授权

<Your_API_Key>

是

您的个人 API 密钥（如何获取)

类型

ipv4

ipv6

mobile

isp

mix

mix_isp

是

您要扩展的代理类型

请求正文

名称	类型	描述
ids	编号	单个ID或用逗号分隔、用“[ ]”括起的ID数组（获取方法）
优惠券	字符串	促销代码。
periodId	字符串	您在 /reference/list/{type} 请求中选定的时段的 ID
paymentId	字符串	支付系统的ID“69e799e7497b2c153b33faca" - 平衡，"69e799e8497b2c153b33faed" - 你添加到收藏柜中的卡牌

示例（例如 ipv4）

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/prolong/make/ipv4
{
    "ids": ["10"],
    "periodId": "1m",
    "coupon": "",
    "paymentId": "balance"
}

{
    "status": "success",
    "data": {
        "orderId": "69fa4b795a1f522c7a53d589",
        "total": 3.49,
        "listBaseOrderNumbers": [
            "TEST_1778011001948-uc_e_UUf2Z3RtGH"
        ],
        "balance": 1.00
    },
    "errors": []
}

{
    "status": "error",
    "data": {
        "warning": "Insufficient funds. Total $3.49. Not enough $2.49",
        "balance": 1.00,
        "total": 3.49,
        "quantity": 1,
        "currency": "USD",
        "discount": 3.00,
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_f7iNLfHqK8",
                "base_order_number": "TEST_1778011001948-uc_e_f7iNLfHqK8",
                "ip": "11.55.11.0",
                "port_http": null,
                "port_socks": null,
                "login": "x2alltop0qRU6",
                "password": "gwBwtL9LMM",
                "authIp": "",
                "country": "Germany",
                "date_start": "05.05.2026 19:56:42",
                "date_end": "10.08.2026 23:59:59",
                "comment": "",
                "status": "Active",
                "rotation": null,
                "link_reboot": "#",
                "can_prolong": true
            }
        ],
        "orders": 1
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "Set existed [periodId] from reference",
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "IP not found",
            "customData": null
        }
    ]
}

POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/comment/set

添加评论

请附上一条自由文本备注（最多 256 个字符），以便在用户界面或导出文件中识别该 IP。

路径参数

名称	价值	必填项	描述
授权	`<Your_API_Key>`	是	您的个人 API 密钥（如何获取)

请求正文

名称	类型	描述
ids	编号	单个ID或用逗号分隔、用“[ ]”括起的ID数组（获取方法）
评论	字符串	您要添加的评论

示例

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/comment/set
{
    "ids": ["10"],
    "comment": "My server"
}

{
    "status": "success",
    "data": {
        "updated": 1
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "IP not found",
            "customData": null
        }
    ]
}

所有代理端点的通用规则

基础网址

https://proxy-seller.com/personal/api/v2/{YourApiKey}/

身份验证
URL路径中的API密钥。
错误模型
业务错误会返回 HTTP 200 状态码，并附带errors[] 已填充。

在您管理完 IP 地址后

Authorizationissue per-order credentialsOpen Order actionsbuy more proxies when you need additional IPsOpen Balancecheck funds before bulk prolongationOpen

路径参数

查询参数

示例

回复

路径参数：

可选参数

示例

回复

修改

路径参数

请求正文

示例

回复

计算扩展名

路径参数

请求正文

示例（例如 ipv4）

回复

创建续订订单

路径参数

请求正文

示例（例如 ipv4）

回复

路径参数

示例

回复

所有代理端点的通用规则

基础网址

身份验证

错误模型

在您管理完 IP 地址后

On this page