要使用动态住宅出口,先购买按流量计的额度,再去提取主机、端口和认证信息。提取凭据假定流量已经买好;本页只讲怎么按官方动态订单完成购买。文档写明:动态订单用于购买按流量使用的动态代理资源,并且与网页开通使用同一条处理链路。
购买前先核对账户余额。价格结构见按 GB 还是按 IP。买成功后,动态资源2应使用购买响应中的 accountId 调用账户级提取,不要拿订单号去代替。仅限授权目标。不支持中国大陆使用。
开始前备齐什么
| 准备项 | 从哪里来 |
|---|---|
| 足够的账户余额 | 控制台或余额接口;不够先充值 |
| 动态产品编号 | 以产品查询或控制台为准;动态资源2的公开产品号是 dynamic_2,下单前仍建议再确认 |
| 要购买的流量 | trafficAmount 单位是 GB,必须大于 0 |
| 若走 API:访问令牌 | 见登录与 Token |
在控制台为本人开通时,按页面完成购买即可,不必把接口里的 userId 理解成「每位买家都要再填一个外部会员号」。若走官方创建接口,文档把 userId 列为必填,且它是目标用户在 ZTProxy 系统中的用户 ID,不是调用方自己的会员编号。
文档中的下单字段
创建接口是 POST /open/app/order/create/v2。基础地址为 https://backend.ztproxy.net/api。
| 字段 | 必填 | 说明 |
|---|---|---|
orderType | 是 | 动态代理使用 dynamic_proxy |
poolId | 是 | 动态代理产品编号 |
trafficAmount | 是 | 购买流量,单位为 GB,必须大于 0 |
userId | 接口文档为是 | ZTProxy 系统中的目标用户 ID;控制台本人开通不按「外部会员号」去填 |
unitPrice、totalAmount | 是(兼容字段) | 请传 0;服务端按目标用户、代理层级和流量阶梯计算实际单价,客户端金额不是扣款依据 |
remark | 否 | 订单备注 |
文档写明:接口会先在服务端完成价格解析和用户、代理商余额预检,再执行资源开通;成功后在同一订单号下记录用户、代理商(如有)和平台成本流水。任一必要步骤失败时,订单不会以「部分扣款」状态提交。官方示例里还可能出现其他兼容字段;本页只依据字段说明表解释已核实项,不给未说明的字段编造含义。
创建动态订单示例
export ZTPROXY_BASE="https://backend.ztproxy.net/api"
export ZTPROXY_TOKEN="TOKEN_EXAMPLE_NOT_REAL"
# Official userId is an integer ZTProxy user id, not an external member id.
# 1001 appears in official docs as a sample only; it is not a live account.
USER_ID=1001
curl -X POST "$ZTPROXY_BASE/open/app/order/create/v2" \
-H "Authorization: Bearer $ZTPROXY_TOKEN" \
-H "Content-Type: application/json" \
-d "{
\"orderType\": \"dynamic_proxy\",
\"poolId\": \"dynamic_2\",
\"trafficAmount\": 3,
\"unitPrice\": 0,
\"totalAmount\": 0,
\"remark\": \"API dynamic order example\",
\"userId\": ${USER_ID}
}"
trafficAmount 示例中的 3 只表示 3 GB,不是套餐名,也不是成交价。实际应付以服务端计价和控制台为准。下单成功后保存订单号,并保存购买响应中的 accountId,再去提取。可用文档中的订单列表或详情接口按订单号查询,不必在本页再贴一组查询示例。
买完之后和常见坑
| 情况 | 建议 |
|---|---|
| 购买已成功,下一步要出口 | 用 accountId 按提取凭据领取完整主机、端口、用户名和密码,不要自己拼接用户名 |
| 返回余额不足 | 先充值或减小 trafficAmount,不要原样重试 |
| 想指定国家或城市再提取 | 提取时再查目录传参,见指定地区;不要在本页编造下单时的城市语法 |
| 想先看还剩多少流量 | 见剩余流量,不要把余额当成流量额度 |
| 请求在拿到响应前超时 | 先按时间、目标和产品查订单列表,确认是否已经生成订单,再决定是否重试,避免重复下单 |
查询剩余流量的账户级路径与购买接口不是同一条。动态资源2的完整提取、地区和用量说明见动态资源2接入指南。
合规与范围
只用于授权目标。不要把本页写成绕过限制的教程。价格以控制台与价格方案为准(动态约 $0.40/GB,100 TB 整包约 $0.20/GB;静态共享约 $1.50、独享约 $5 /IP/月)。USDT/USDC 可用;Visa/Mastercard 申请中。不支持中国大陆使用。
FAQ
不买流量能不能直接提取?
提取建立在已经购买的动态账户上。本页先完成购买;提取步骤见配套指南,不要把两步写成一件事。
为什么单价和总金额要传 0?
文档把它们定为兼容字段,要求传 0,由服务端计价。客户端传入的金额不是扣款依据。不要改成自己估算的单价。
控制台购买和 API 购买是两套价格吗?
文档写明与网页开通使用同一条处理链路,包括价格解析、余额预检、资源开通和记账。最终应付以服务端和控制台为准。
userId 是不是我自己系统里的会员号?
不是。若走创建接口,它必须是 ZTProxy 系统中的用户 ID。调用方如果只有自己的会员编号,应先完成映射,不能直接复制过去。缺少该字段时,相关创建接口可能在进入开通和扣款前就失败。
购买失败会不会只扣一部分钱?
文档写明:任一必要步骤失败时,订单不会以「部分扣款」状态提交。对账仍以交易记录和余额为准。
动态资源2的产品号一定是 dynamic_2 吗?
既有官方说明把 dynamic_2 作为动态资源2的公开产品号。下单前仍以产品查询或控制台当时显示的产品编号为准。
这和静态住宅 IP 有什么不同?
动态按 GB 购买流量,买完再提取出口;静态按 IP 和时长订购固定地址,见购买静态 IP。粘性会话也不能代替静态 IP,见粘性会话设置。
价格以哪里为准?
以控制台与价格方案为准。示例中的 3 GB 或 0 元字段不是成交价。