操作顺序
Updated:
通过编程方式订购新 IP 地址——无需打开控制面板。
流程
完整信息GET/reference/list
请查询有效的国家代码、时段、目标和运营商。接下来的两个步骤将需要这些代码。
计算顺序POST/order/calc
进行模拟交易。返回价格和验证错误,且不消耗余额。
下单POST/order/make
处理费用结算并分配IP。返回订单ID和IP列表。
开始之前
API密钥
在仪表盘中生成一份。
可用余额
请通过 /balance 进行核对。
SDK(可选)
PHP、Node、Python、Go、Java。
所有订单端点的通用要求
基础网址
https://proxy-seller.com/personal/api/v2/{YourApiKey}/身份验证
URL路径中的API密钥。
错误模型
业务错误会返回 HTTP 200 状态码,同时包含
errors[]已填充。
下单后
Authorizationsissue per-order credentials so apps can connect through these IPsOpenExtend proxiesauto-renewal settings, work without stopping processesOpenBalancecheck funds before bulk prolongationOpen常见问题解答
三个步骤:complete-information → 获取有效的国家/时期/目标ID;calculate-the-order → 确认最终价格;place-an-order → 地点。之后make,投票retrieve-active-proxy 直到出现IP地址为止。
仅place-an-order 实际上是由用户决定的——API 并不强制要求特定的调用顺序。complete-information 以及calculate-the-order 属于辅助功能:ID查询和价格预览。若您已拥有有效的ID,请跳过这些步骤,并接受由place-an-order.
order-actions 用于购买新 IP 地址。extend-proxies 用于续订现有 IP 地址(prolong/calc,prolong/make). 它们使用不同的端点,并且可能接受不同的 paymentId 值。
美元(USD)。不存在按账号设置的货币覆盖选项。
没有公开的order/list 此范围内的端点。在您自己的系统中跟踪订单 ID,从place-an-order 回复,并使用retrieve-active-proxy?orderId=… 逐一检查。
不要通过编程方式实现。一旦order/make 若返回成功,资金将被扣除,IP地址正在分配中。如需申请退款,请通过仪表盘或联系客服。
不。所有调用都会使用您的真实 API 密钥连接到生产环境。为了安全地测试集成,请充值最低余额并订购最小可用数量。