查询 ZTProxy 产品、地区、库存和价格。基础地址：https://backend.ztproxy.net/api

产品

产品定义了可购买的代理资源。创建订单前，请先查询产品，确认正确的 poolId、地区、时长、IP 数量和价格。

查询产品

创建订单前，先通过产品查询接口获取可购买产品、库存、价格和地区代码。

curl -X POST "https://backend.ztproxy.net/api/open/app/product/query-standard/v2" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "proxyType": 103,
    "language": "zh"
  }'

可按国家或城市筛选：

curl -X POST "https://backend.ztproxy.net/api/open/app/product/query-standard/v2" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "proxyType": 103,
    "standardCountryCode": "US",
    "standardCityCode": "NEW_YORK",
    "language": "en"
  }'

常用响应字段：

language 可传 zh 或 en，默认 en。当前可购买产品的国家和城市会同时返回 countryNameEn / countryNameZh、cityNameEn / cityNameZh，countryName 和 cityName 会按请求语言返回。

示例响应：

{
  "code": 0,
  "msg": "success",
  "data": {
    "items": [
      {
        "productId": "ZT_US_New York City_2",
        "name": "United States New York",
        "proxyType": 103,
        "countryCode": "US",
        "countryName": "美国",
        "countryNameEn": "United States",
        "countryNameZh": "美国",
        "cityCode": "NEW_YORK",
        "cityName": "纽约",
        "cityNameEn": "New York",
        "cityNameZh": "纽约",
        "nameLanguage": "zh",
        "price": 1.2,
        "stock": 20,
        "product_type": 2,
        "project_list": [
          { "code": "game", "name": "游戏业务", "inventory": 10 }
        ],
        "duration": 30,
        "unit": 1
      }
    ],
    "total": 1
  }
}

地区代码规则

下单时请使用产品查询接口返回的 countryCode 和 cityCode：

同一个国家或城市可能有多个可购买产品。创建订单时请同时传入对应产品的 productId、countryCode 和 cityCode。

共享静态和独享静态判别

静态产品的共享/独享形态以产品响应字段为准：

staticType 表示静态资源/供应商类型，不用于判别共享或独享。客户创建订单时应以产品列表返回的 productId 作为 poolId。

查询国家或城市拥有的 IP 段

使用 GET /open/app/product/ip-ranges/v2 查询指定产品下可用的 CIDR/IP 段列表。

curl -X GET "https://backend.ztproxy.net/api/open/app/product/ip-ranges/v2?proxyType=103&productNo=<productId>" \
  -H "Authorization: Bearer <token>"

查询参数：

示例响应：

{
  "code": 0,
  "msg": "success",
  "data": {
    "items": [
      {
        "productId": "ZT_US_New York City_2",
        "name": "United States New York",
        "proxyType": 103,
        "product_type": 2,
        "project_list": [
          { "code": "game", "name": "游戏业务", "inventory": 10 }
        ],
        "area": "6",
        "areaCode": "6",
        "country": "USA",
        "countryCode": "USA",
        "countryName": "United States",
        "state": "USA0NY",
        "stateCode": "USA0NY",
        "stateName": "New York",
        "city": "USA0NYQEE",
        "cityCode": "USA0NYQEE",
        "cityName": "New York",
        "stock": 20,
        "ipRanges": [
          {
            "ipRange": "198.51.100.0/24",
            "cidr": "198.51.100.0/24",
            "count": 256,
            "available": 256,
            "asn": "AS12345",
            "isp": "Example ISP",
            "projectList": [],
            "enable": "1"
          }
        ],
        "ipRangeCount": 1
      }
    ],
    "totalProducts": 1,
    "totalIpRanges": 1
  }
}

常见产品类型

选择产品建议

1. 按 proxyType 查询产品。

2. 检查 inventory 和地区字段。

3. 确认时长规则。普通静态产品中，unit 支持 1 天、3 月、4 年，具体 duration 取值以产品配置为准。

4. 创建订单时使用 product_no 作为 poolId。

5. 如果产品包含 project_list，请选择库存充足的 projectId。