Proxy-seller

代理和订单

Updated:

权限:account:read,account:write,计费:撰写

在本小组中

工具

功能说明

list_proxies

🟢read

您当前活跃的某类代理:IP、HTTP/SOCKS端口、凭据、国家/地区、有效期、自动续期状态及备注。

export_proxies

🟢read

将代理服务器导出为可直接使用的列表,每行一个代理。

get_reference

🟢read

某类产品的适用国家、租赁期限及套餐方案。

calc_order_cost

🟢read

新订单的价格和折扣,无需下单。

make_order

💳pays

下达新的代理订单。

list_orders

🟢read

您的订单(按最新顺序排列)以及该账户中已有的使用目标。

check_order_status

🟢read

检查已下单的委托是否已发出。

calc_prolong_cost

🟢read

特定代理的续费价格(不包含续费操作)。

make_prolong

💳pays

将代理授权续期。

replace_proxy

🟡write

请求更换无法正常工作的代理服务器。

set_proxy_comment

🟡write

在一個或多個代理上設置相同的註釋。

list_proxies

🟢read-only · account:read

您当前活跃的某类代理:IP、HTTP/SOCKS端口、凭据、国家/地区、有效期、自动续期状态及备注。password 除非您主动要求,否则返回的结果将经过匿名处理。使用代理时status: "Ended" 是即将结束,未过期 —date_end 是实际到期时间。

参数

类型

描述

type 必填

代理类型

产品类型。mix 仅限 IPv4 MIX 包,且mix_isp ISP MIX 套餐——包含两项独立列表,因此“我所有的 MIX 代理”指的就是这两项。subresident 此处不提供该服务:请使用list_resident_subuser_lists

orderId

字符串 | 整数

仅限一笔订单

country

字符串

Alpha-3 代码,例如:USA

latest

布尔值

仅限最近签发的代理

ends

布尔值

仅限即将到期的代理

page,per_page

整数

返回页面(默认1) 和页面大小(默认50)

reveal

布尔值

返回password 用“清晰”代替••••。助理会先与您确认——参见代理密码和AI提供商

返回: {items: [...]} — 每个代理仅处理一个对象,且id,ip,protocol,port_http,port_socks,login,password,country,country_alpha3,date_start,date_end,status,status_type,can_prolong,auto_renew,comment,order_id,order_number,base_order_number。搜索结果按页显示(默认每页50条),并包含page,per_page,total,total_pages,以及一份_note 当存在更多页面时。例如resident 这些项目是住宅列表,而非 IP 地址。对于mix /mix_isp 一个包在多个国家发行:order_number 以及base_order_number 添加各国专属后缀(NS_…-dX_GBR,NS_…-dX_DEU) 同时order_id 共享——按组分类order_id; a_note 结果中已明确说明。password 是"••••" 除非reveal: true. ⚠️敏感数据 — 结果中包含一条警告,助手会向您重复该警告。

export_proxies

🟢read-only · account:read

将代理服务器导出为可直接使用的列表,每行一个代理。默认情况下,代理地址将被屏蔽:ip:port。使用reveal: true 这些行可以连接login:password@host:port.

参数

类型

描述

type 必填

代理类型,包括subresident

产品类型

ext

字符串

txt (默认),csv,或使用类似的模板,例如%login%:%password%@%ip%:%port%. 无reveal,txt 变为%ip%:%port%;csv (其固定版式ip;port;login;password (始终包含密码)以及模板命名%password% 在您确认显示之前,这些内容将被拒绝

proto

https |socks5

仅限一种端口类型(不适用于住宅网络)

protocol

http |socks5

仅限住宅区(resident,subresident):每行的结构。使用txt 该行应改为socks5://login:password@host:port;csv 保留其列;模板会获取其中的值%protocol% (模板中不得包含/,因此请使用txt forscheme:// 行)。没有它,行就失去了结构。这与proto;没有https.socks5 还支持 UDP 和 HTTP/3(QUIC)

host

res.proxy-seller.com |us.res.proxy-seller.com |asia.res.proxy-seller.com

仅限住宅网络:每行中的网关——欧洲(默认)、美国或亚洲。仅指入口点;出口IP位置来自列表设置

country

字符串

Alpha-3 代码(非住宅用途)

ends

布尔值

仅限即将到期的代理(不适用于住宅用途)

listId

字符串 | 整数

住宅列表 ID(resident 以及subresident); 省略所有列表的导出

package_key

字符串

子包键,包含type: "subresident"

maxLine

整数

最大行数,仅限住宅区

reveal

布尔值

返回可连接login:password@host:port 行,而不是ip:port。助理会先与您确认——参见代理密码和AI提供商

返回: 在住宅区protocol 这些行体现了以下方案:socks5://host:port 默认情况下,socks5://login:password@host:port withreveal: true. 无reveal 这些行后面附有一条注释,说明密码已被省略——助手会转达这一信息,因此绝不会将不含密码的列表作为您所要求的凭据呈现。询问csv 正在询问密码:助手会提醒您,该文件将把您的代理凭据添加到对话中,并在导出前要求您确认。

get_reference

🟢read-only · account:read

某类产品的适用国家、租赁期限及套餐方案。在定价或下单前需提供此信息。国家名称采用3位字母代码(USA),句点是简写代码(1m)。对于移动端,它还会显示运营商和资费套餐选项;对于住宅用户,则显示通信资费。

参数

类型

描述

type 必填

代理类型

产品类型

calc_order_cost

🟢read-only · account:read

新订单的价格和折扣,无需下单。采用与make_order.

make_order

💳spends money · billing:write

下达新的代理订单。将从余额中扣款。若调用两次,将生成两个订单。

参数

类型

描述

type 必填

代理类型

产品类型(使用make_resident_order (适用于住宅区流量)

countryId 必填

字符串

来源get_reference,例如:USA

periodId 必填

字符串

来源get_reference,例如:1m

quantity 必填

整数

代理数量(ipv6 (最少10条)

paymentId 必填

字符串

balance 或paddle_subscription

customTargetName

字符串

代理服务器的作用,作为网站或服务的简短名称(如 Google、Instagram)。必填项ipv4,ipv6,isp. 该账户从未使用过的收货地址被视为新地址:需由经理手动审批,在此之前订单将保持待处理状态,因此助理通常会优先选择该账户已有的收货地址之一(list_orders →targets)

coupon

字符串

促销代码

generateAuth

布尔值

为新代理生成登录名/密码

protocol

HTTPS |SOCKS5

协议覆盖

mobileServiceType

shared |dedicated

仅限移动端,必填

operatorId

字符串

仅限移动端,必填——运营商来自get_reference

rotationId

字符串

仅限移动端,必填 — 轮播间隔(单位:分钟)从get_reference

mixId

字符串

仅限 MIX — 代码包来自get_reference

uptime

布尔值

仅限 IPv4/ISP — 如提供,则采用高可用性模式

常见错误: 订单已付款但处于待处理状态超过一分钟。当其customTargetName 是该账号的新用户,provisioning.targetNote 据称:CRM系统创建了一个新的使用目标,经经理手动批准后,代理权才被发放——支付和股票方面均无问题。稍后请与check_order_status,或者下次重复使用现有的目标。

list_orders

🟢read-only · account:read

您的订单(按最新顺序排列)——包括购买和续费——及其ID、状态、金额、日期、代理类型和使用目标,以及该账户的特定使用目标。请据此选择一个customTargetName 在订购前,请确认该账号已有的内容,以查找order_id 重视ipv6 /mix /mix_isp 续订需orderIds,以及订单历史记录。

参数

类型

描述

order_id

字符串 | 整数

一笔订单(order_id 返回其连字符形式;一行中的数值id 返回该行)

start_date /end_date

字符串

创建日期范围,yyyy-MM-dd 或dd.MM.yyyy

status

PAYED |NOT_PAYED |RETURN

机器状态过滤器

is_extend

布尔值

true 仅限扩展内容,false 仅限购买

auto_order

布尔值

true 通过 API 放置或自动刷新,false 手动放置

page /limit

整数

分页,默认每页50行;a_note 当存在更多页面时会显示此提示。targets 始终涵盖所有匹配的顺序

返回: {metadata: {total_orders, total_pages, current_page, current_limit}, items: [{id, order_id, order_number, base_order_number, status, status_type, summ, date_insert, date_payed, payment_name, is_extend, auto_order, auth_way, auth_ip, protocol, items: [{order_part_id, type, quantity, target, target_section, time, price, name, ...}], ...}], targets: string[], _note?}.summ 是一个货币字符串($12.50),日期格式遵循 ISO 8601 标准;使用目标位于每个订单部件上(items[].items[].target); 分支于status_type,而非status.

check_order_status

🟢read-only · account:read

通过统计代理数量,检查已下单的代理是否已发放list_proxies 适用于订单——每种类型均包含MIX套餐。虽然MIX订单中尚未列出IP地址,但按国家/地区划分的登录信息在list_auth 是备选依据(started)。可安全地反复调用;返回状态及后续步骤。控制柜根据其order_part_id,这与orderId;即保持相同的顺序。

参数

类型

描述

type 必填

代理类型

产品类型

orderId 必填

字符串 | 整数

orderId 来源make_order

expectedQuantity

整数

订购数量,用于检测部分交货

baseOrderNumbers

string[]

仅限 MIX —listBaseOrderNumbers 来自make_order 响应,用于登录备用方案

返回: status 是provisioned,partial,started (混合:已存在登录信息,IP地址尚未列出)或pending.proxies[] 是已发布的记录,其中包含password masked — 使用list_proxies /export_proxies withreveal: true 用于身份验证。

calc_prolong_cost

🟢read-only · account:read

特定代理的续费价格(不续费)。参数与make_prolong.

返回: items 是需要续期的代理,password masked.

make_prolong

💳spends money · billing:write

续订代理服务至下一个周期。费用将从所选支付方式中扣除。若调用两次,则收取两次费用。

参数

类型

描述

type 必填

ipv4 |ipv6 |mobile |isp |mix |mix_isp

产品类型。住宅套餐不按周期续订——通过购买流量来make_resident_order

periodId 必填

字符串

来源get_reference

paymentId 必填

字符串

balance 或来自list_payments

ips

string[]

ipv4 /isp /mobile:代理地址如下list_proxies 显示它们

ids

(字符串 | 整数)[]

ipv4 /isp /mobile: 代理 ID

orderIds

(字符串 | 整数)[]

ipv6 /mix /mix_isp:该order_id 数值来自list_proxies. 这些产品以整笔订单的形式销售和续订——订单中的每个有效代理都会被续订并收取费用

coupon

字符串

促销代码

具体应用哪个选择器取决于type:ipv4,isp 以及mobile takeids 或ips;ipv6,mix 以及mix_isp takeorderIds. 对于整批订单类型,您仍可传递ids 或ips ——助手的工具会将其解析为相应的指令——但 API 本身仅接受orderIds 那里。

常见错误: 对于仍在续订中的订单,第二次续订请求在付款前被拒绝(代码 57,“已处理中”)——不会产生任何费用;请稍后查看list_proxies 而不是盲目重试。“未应用续费,款项已退回账户余额”意味着续费操作已被撤销,款项已退回账户余额。

replace_proxy

🟡changes account state · account:write

请求更换无法正常工作的代理。每个代理每天可更换一次。

参数

类型

描述

ids 必填

(字符串 | 整数)[]

代理ID

reason 必填

NOT_WORK |INCORRECT_LOCATION |CANT_CHANGE_NETWORK |LOW_SPEED |CUSTOM

理由

comment

字符串

在以下情况下必须:reason 是CUSTOM

set_proxy_comment

🟡changes account state · account:write

在一个或多个代理上设置相同的注释。该操作将替换之前的注释;空字符串将清除注释。

参数

类型

描述

ids 必填

(字符串 | 整数)[]

代理ID

comment 必填

字符串

注释文本

后续步骤

On this page