# 查询静态城市

按国家三字码查询可选静态城市。

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

## 请求

`GET /openapi/v1/static/cities`

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

## 返回

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

## 错误与重试

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