查询静态城市

所有路径均使用统一 API 令牌认证。响应封装、业务编号和通用错误处理见静态 API 概览。接口合同不代表目标环境已开放或完成真实供应商验收。

请求

GET /openapi/v1/static/cities

必填查询参数 countryCode 为三字国家码，例如 USA；可选 ispType 为 1 或 2。无请求体。

返回

HTTP 200 的 data.items[] 包含 countryCode、cityCode、cityName。目录按已开放商品去重排序；无匹配商品时为空数组，暂时缺货不会隐藏地区。

错误与重试

缺少或写错 countryCode 时先修正参数；429 按 Retry-After 等待，500/503 可有限重试读取。城市目录不是库存承诺。