怎么购买动态住宅流量:下单后才能提取

按官方动态订单说明购买按 GB 计的动态住宅流量。网页开通与接口走同一条计价和开通链路;动态单价请传 0 由服务端计算。买成功后再去提取凭据。不支持中国大陆。

要使用动态住宅出口,先购买按流量计的额度,再去提取主机、端口和认证信息。提取凭据假定流量已经买好;本页只讲怎么按官方动态订单完成购买。文档写明:动态订单用于购买按流量使用的动态代理资源,并且与网页开通使用同一条处理链路。

购买前先核对账户余额。价格结构见按 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 元字段不是成交价。

下一步

  1. 确认余额和产品编号,再创建动态订单。
  2. 保存 accountId 与订单号。
  3. 前往提取凭据,需要定点时再看指定地区。