创建静态住宅 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公开产品号时仍建议再确认。完整购买步骤见购买动态流量。
价格以哪里为准?
以控制台、当时的产品查询和价格方案为准。不要沿用旧截图里的价格或库存。