下单前怎么查询住宅代理产品、地区和价格

创建静态或动态订单前,先用官方产品查询获取产品编号、地区代码、时长、价格和库存。共享或独享以产品形态字段为准,不要把 staticType 当成 ISP 套餐。不支持中国大陆。

创建静态住宅 IP 或确认动态住宅产品编号之前,先查询当前可买的产品、地区、时长、价格和库存。官方产品文档写明:创建订单前,请先查询产品,确认正确的 poolId、地区、时长、IP 数量和价格。本页是操作 how-to,不是改写营销站产品枢纽的标题或介绍,也不代替按目标市场选地区的怎么选出口地区。

查到的 productId 在下单时作为 poolId 使用。静态下单见购买静态住宅 IP;动态下单见购买动态流量。仅限授权目标。不支持中国大陆使用。

开始前备齐什么

准备项从哪里来
访问令牌或已登录控制台接口需要有效令牌,见登录与 Token
代理类型文档常见值:103 表示静态,104 表示动态
可选的国家或城市筛选标准国家代码用 ISO2,文档示例为 US、JP;城市代码文档示例为 NEW_YORK
返回语言可传 zh 或 en,文档默认 en

这些国家或城市代码只是文档示例,不表示此刻一定有库存。库存以此次查询响应或控制台为准,不要把文档示例里的数字抄成现网库存。

先看清这些返回字段

查询接口是 POST /open/app/product/query-standard/v2。

字段说明
productId产品编号,创建订单时作为 poolId
proxyType代理类型;常见值 103 静态、104 动态
product_type / productType静态形态:2 或 shared 为共享静态;1 或 exclusive 为独享静态
project_list / projects / projectList共享静态的项目或业务类型列表;非空时下单要选并传入 projectId
stock当时查询到的可用库存
countryCode、cityCode标准国家、城市代码,下单时原样使用
duration、unit、price支持的时长配置和当前产品默认销售价格

共享还是独享,以产品响应里的形态字段和项目列表为准,不要用 staticType 判断。文档写明:staticType 表示静态资源类型,不用于判别共享或独享。也不要把官方示例里可能出现的 staticType 值写成营销 ISP 套餐;本站售卖的是住宅产品,对照见ISP vs 住宅。共享与独享怎么选,见共享静态 vs 独享静态。

查询静态产品示例

export ZTPROXY_BASE="https://backend.ztproxy.net/api"
export ZTPROXY_TOKEN="TOKEN_EXAMPLE_NOT_REAL"

curl -X POST "$ZTPROXY_BASE/open/app/product/query-standard/v2" \
  -H "Authorization: Bearer $ZTPROXY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "proxyType": 103,
    "language": "zh"
  }'

若要按国家或城市缩小范围,按文档追加 standardCountryCode 和 standardCityCode。查询动态产品时,把 proxyType 换成 104。英文文档见 Products,字段与中文页一致。文档还提供按产品查询 IP 段的接口;那是补充能力,本页不展开 CIDR 示例,以免把文档里的示意网段或 ISP 名称写成可售库存。

查完之后怎么用,以及不要做什么

查到什么下一步不要做什么
静态 productId、国家/城市代码、时长和价格带到静态下单不要手写过期的产品号或地区代码
共享静态且项目列表非空选一个项目代码,下单时传 projectId不要把独享静态的请求硬加上项目代码,或把共享静态的项目代码省掉
stock 为 0 或不足换其他仍有库存的产品或地区,或稍后再查不要把历史截图或文档示例库存当成当前可买数量
动态产品编号带到动态下单不要用静态产品号去买流量

最佳实践也提醒:创建订单前即时查询产品,确保库存、时长和价格是最新的。价格仍以控制台和查询当时返回为准,不是本页或营销文案里的示意价。

合规与范围

只用于授权目标。不要把本页写成绕过限制的教程。价格以控制台与价格方案为准(动态约 $0.40/GB,100 TB 整包约 $0.20/GB;静态共享约 $1.50、独享约 $5 /IP/月)。USDT/USDC 可用;Visa/Mastercard 申请中。不支持中国大陆使用。

FAQ

这和产品介绍页有什么不同?

/products 是产品枢纽,本页不改它的标题或简介。本页教你在下单前查询实时产品编号、地区、时长、价格和库存。

103 和 104 分别是什么?

官方产品文档的常见值:103 为静态,104 为动态。不要发明其他未文档化的类型码。

怎样判断共享静态还是独享静态?

看 product_type / productType,以及项目列表是否非空。不要用 staticType 判断,也不要把 staticType 当成 ISP 套餐。

文档示例里的美国或纽约一定有货吗?

不一定。示例只说明代码格式。是否可买,以这次查询的 stock 和控制台为准。

查询结果里的 price 能当发票金额吗?

它是当前产品默认销售价格,下单时仍可能按服务端规则计算。最终应付以控制台和下单结果为准。

没有库存还能下单吗?

应先换有库存的产品或稍后再查。把过期查询结果拿去下单,容易在校验阶段失败。

动态流量也要先查产品吗?

动态订单需要正确的产品编号。已知动态资源2公开产品号时仍建议再确认。完整购买步骤见购买动态流量。

价格以哪里为准?

以控制台、当时的产品查询和价格方案为准。不要沿用旧截图里的价格或库存。

下一步

  1. 按静态或动态查询产品,保存 productId 和地区、时长字段。
  2. 确认共享或独享,以及是否需要 projectId。
  3. 转到购买静态 IP或购买动态流量。