代理和订单
Updated:
权限:account:read,account:write,计费:撰写
在本小组中
工具 | 功能说明 | |
|---|---|---|
🟢 | 您当前活跃的某类代理:IP、HTTP/SOCKS端口、凭据、国家/地区、有效期、自动续期状态及备注。 | |
🟢 | 将代理服务器导出为可直接使用的列表,每行一个代理。 | |
🟢 | 某类产品的适用国家、租赁期限及套餐方案。 | |
🟢 | 新订单的价格和折扣,无需下单。 | |
💳 | 下达新的代理订单。 | |
🟢 | 您的订单(按最新顺序排列)以及该账户中已有的使用目标。 | |
🟢 | 检查已下单的委托是否已发出。 | |
🟢 | 特定代理的续费价格(不包含续费操作)。 | |
💳 | 将代理授权续期。 | |
🟡 | 请求更换无法正常工作的代理服务器。 | |
🟡 | 在一個或多個代理上設置相同的註釋。 |
list_proxies
🟢read-only · account:read
您当前活跃的某类代理:IP、HTTP/SOCKS端口、凭据、国家/地区、有效期、自动续期状态及备注。password 除非您主动要求,否则返回的结果将经过匿名处理。使用代理时status: "Ended" 是即将结束,未过期 —date_end 是实际到期时间。
参数 | 类型 | 描述 |
|---|---|---|
| 代理类型 | 产品类型。 |
| 字符串 | 整数 | 仅限一笔订单 |
| 字符串 | Alpha-3 代码,例如: |
| 布尔值 | 仅限最近签发的代理 |
| 布尔值 | 仅限即将到期的代理 |
| 整数 | 返回页面(默认 |
| 布尔值 | 返回 |
返回: {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.
参数 | 类型 | 描述 |
|---|---|---|
| 代理类型,包括 | 产品类型 |
| 字符串 |
|
|
| 仅限一种端口类型(不适用于住宅网络) |
|
| 仅限住宅区( |
|
| 仅限住宅网络:每行中的网关——欧洲(默认)、美国或亚洲。仅指入口点;出口IP位置来自列表设置 |
| 字符串 | Alpha-3 代码(非住宅用途) |
| 布尔值 | 仅限即将到期的代理(不适用于住宅用途) |
| 字符串 | 整数 | 住宅列表 ID( |
| 字符串 | 子包键,包含 |
| 整数 | 最大行数,仅限住宅区 |
| 布尔值 | 返回可连接 |
返回: 在住宅区protocol 这些行体现了以下方案:socks5://host:port 默认情况下,socks5://login:password@host:port withreveal: true. 无reveal 这些行后面附有一条注释,说明密码已被省略——助手会转达这一信息,因此绝不会将不含密码的列表作为您所要求的凭据呈现。询问csv 正在询问密码:助手会提醒您,该文件将把您的代理凭据添加到对话中,并在导出前要求您确认。
get_reference
🟢read-only · account:read
某类产品的适用国家、租赁期限及套餐方案。在定价或下单前需提供此信息。国家名称采用3位字母代码(USA),句点是简写代码(1m)。对于移动端,它还会显示运营商和资费套餐选项;对于住宅用户,则显示通信资费。
参数 | 类型 | 描述 |
|---|---|---|
| 代理类型 | 产品类型 |
calc_order_cost
🟢read-only · account:read
新订单的价格和折扣,无需下单。采用与make_order.
make_order
💳spends money · billing:write
下达新的代理订单。将从余额中扣款。若调用两次,将生成两个订单。
参数 | 类型 | 描述 |
|---|---|---|
| 代理类型 | 产品类型(使用make_resident_order (适用于住宅区流量) |
| 字符串 | 来源get_reference,例如: |
| 字符串 | 来源get_reference,例如: |
| 整数 | 代理数量( |
| 字符串 |
|
| 字符串 | 代理服务器的作用,作为网站或服务的简短名称(如 Google、Instagram)。必填项 |
| 字符串 | 促销代码 |
| 布尔值 | 为新代理生成登录名/密码 |
|
| 协议覆盖 |
|
| 仅限移动端,必填 |
| 字符串 | 仅限移动端,必填——运营商来自get_reference |
| 字符串 | 仅限移动端,必填 — 轮播间隔(单位:分钟)从get_reference |
| 字符串 | 仅限 MIX — 代码包来自get_reference |
| 布尔值 | 仅限 IPv4/ISP — 如提供,则采用高可用性模式 |
常见错误: 订单已付款但处于待处理状态超过一分钟。当其customTargetName 是该账号的新用户,provisioning.targetNote 据称:CRM系统创建了一个新的使用目标,经经理手动批准后,代理权才被发放——支付和股票方面均无问题。稍后请与check_order_status,或者下次重复使用现有的目标。
list_orders
🟢read-only · account:read
您的订单(按最新顺序排列)——包括购买和续费——及其ID、状态、金额、日期、代理类型和使用目标,以及该账户的特定使用目标。请据此选择一个customTargetName 在订购前,请确认该账号已有的内容,以查找order_id 重视ipv6 /mix /mix_isp 续订需orderIds,以及订单历史记录。
参数 | 类型 | 描述 |
|---|---|---|
| 字符串 | 整数 | 一笔订单( |
| 字符串 | 创建日期范围, |
|
| 机器状态过滤器 |
| 布尔值 |
|
| 布尔值 |
|
| 整数 | 分页,默认每页50行;a |
返回: {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;即保持相同的顺序。
参数 | 类型 | 描述 |
|---|---|---|
| 代理类型 | 产品类型 |
| 字符串 | 整数 |
|
| 整数 | 订购数量,用于检测部分交货 |
| string[] | 仅限 MIX — |
返回: 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
续订代理服务至下一个周期。费用将从所选支付方式中扣除。若调用两次,则收取两次费用。
参数 | 类型 | 描述 |
|---|---|---|
|
| 产品类型。住宅套餐不按周期续订——通过购买流量来make_resident_order |
| 字符串 | |
| 字符串 |
|
| string[] |
|
| (字符串 | 整数)[] |
|
| (字符串 | 整数)[] |
|
| 字符串 | 促销代码 |
具体应用哪个选择器取决于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
请求更换无法正常工作的代理。每个代理每天可更换一次。
参数 | 类型 | 描述 |
|---|---|---|
| (字符串 | 整数)[] | 代理ID |
|
| 理由 |
| 字符串 | 在以下情况下必须: |
set_proxy_comment
🟡changes account state · account:write
在一个或多个代理上设置相同的注释。该操作将替换之前的注释;空字符串将清除注释。
参数 | 类型 | 描述 |
|---|---|---|
| (字符串 | 整数)[] | 代理ID |
| 字符串 | 注释文本 |