创建和查询固定 IP 代理订单。基础地址：https://api.wanyuagent.com/api

静态订单

静态代理订单用于购买固定 IP 资源，需要指定产品、地区、时长和 IP 数量。

创建静态订单

使用产品查询接口返回的 productId、countryCode 和 cityCode 创建静态订单。

curl -X POST "https://api.wanyuagent.com/api/open/app/static/order/create-standard/v2" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "orderType": "static_proxy",
    "poolId": "ZT_US_New York City_2",
    "unitPrice": 10,
    "totalAmount": 10,
    "remark": "API static order",
    "userId": 1001,
    "countryCode": "US",
    "cityCode": "NEW_YORK",
    "staticType": "isp",
    "ipCount": 1,
    "cycleTimes": 1,
    "duration": 30,
    "unit": 1
  }'

`userId` 必填与外部会员 ID 映射

userId 是必填整数，表示目标用户在 ZTProxy 系统中的用户 ID。它不是调用方系统的

会员编号。如果调用方使用 memberId 等自有标识，必须先建立会员与 ZTProxy 用户的

映射，再把对应的 ZTProxy 用户 ID 写入 userId。除非已经验证两套 ID 完全一致，

不要直接把 memberId 复制为 userId。

缺少 userId 时，请求会在进入库存、开通和扣款流程前返回 HTTP 422：

{
  "detail": [
    {
      "type": "missing",
      "loc": ["body", "userId"],
      "msg": "Field required"
    }
  ]
}

收到 HTTP 422 后，应根据 detail[].loc 修正请求参数再提交。原样自动重试同一请求

不会成功。

如果产品查询响应显示该产品为共享静态（product_type / productType 为 2 或 shared，或项目列表非空），需要从 project_list / projects / projectList 中选择项目代码，并在请求体中增加 projectId：

{
  "orderType": "static_proxy",
  "poolId": "ZT_US_New York City_2",
  "userId": 1001,
  "countryCode": "US",
  "cityCode": "NEW_YORK",
  "staticType": "isp",
  "ipCount": 1,
  "cycleTimes": 1,
  "duration": 30,
  "unit": 1,
  "unitPrice": 10,
  "totalAmount": 10,
  "projectId": "game"
}

标准静态订单创建接口采用异步受理模式。接口通过参数、权限、余额和基础价格校验后，会先返回本系统订单号；资源开通结果、实例 IP、端口、账号密码和最终状态请后续查询订单列表。

受理成功响应示例：

{
  "code": 0,
  "msg": "订单已受理，正在处理中，请通过订单列表查询最终状态",
  "data": {
    "orderNo": "STA20260611102030abc123",
    "order_no": "STA20260611102030abc123",
    "appOrderNo": "APP20260611102030def456",
    "app_order_no": "APP20260611102030def456",
    "status": "processing",
    "queued": true,
    "async": true
  }
}

orderNo / order_no 为本系统订单号，后续查询、续费或释放时优先使用；appOrderNo / app_order_no 为本系统资源开通请求号。接口返回 queued: true 表示订单已进入后台处理，不代表资源已完成开通。资源侧订单号、实例信息和最终状态以后续 /open/app/static/order/list/v2 查询结果为准。

时长规则

`unit`	含义	常见 `duration`
`1`	天	普通静态产品通常为 `30`；部分静态资源产品支持 `30`、`90`、`365`。
`3`	月	`1`、`3`、`6`、`12`；部分静态资源产品支持 `1`、`3`、`12`。
`4`	年	`1`。

可选字段

字段	说明
`cidrBlocks`	CIDR 产品可传 `{ "cidr": "x.x.x.x/yy", "count": 1 }` 数组。
`assignedIp`	指定单个 IP。
`assignedIpList`	指定多个 IP。
`projectId`	共享静态代理产品的项目代码。共享静态必传，独享静态不需要传。
`extBandWidth`	额外带宽。
`bandWidthPrice`	带宽价格。
`bridgePrice`	桥接费用。

查询静态订单

curl -X GET "https://api.wanyuagent.com/api/open/app/static/order/list/v2?page=1&pageSize=10" \
  -H "Authorization: Bearer <token>"

搜索示例：

curl -X GET "https://api.wanyuagent.com/api/open/app/static/order/list/v2?search=STA2026&page=1&pageSize=10" \
  -H "Authorization: Bearer <token>"

curl -X GET "https://api.wanyuagent.com/api/open/app/static/order/list/v2?region=New%20York&status=active" \
  -H "Authorization: Bearer <token>"