获取城市列表 (City List)

1. 接口描述

根据地区代码（areaCode），获取该地区支持的城市列表。

• 请求方式：POST
• 接口地址：/api/dynamic-proxy/geo/list-cities
• 内容类型：application/json

2. 请求头规范 (Header)

所有请求必须包含以下安全校验字段。

字段名	类型	是否必填	描述	示例
X-APP-ID	String	是	应用唯一标识 (appId)	10001
X-NONCE	String	是	随机数	k9m2Pq7wL1
X-TIMESTAMP	Long	是	当前 Unix 时间戳 (秒)	1713165000
X-SIGN	String	是	动态签名	d3b1...

签名生成逻辑请参考：签名生成指南

3. 请求参数 (Body)

请求体需传入 JSON 格式的对象。

参数名	类型	是否必填	描述	示例
areaCode	String	是	地区代码	"Gasa"

---

4. 请求示例

POST /api/dynamic-proxy/geo/list-cities
Host: cueip.com
X-APP-ID: 10001
X-NONCE: 847291
X-TIMESTAMP: 1713164000
X-SIGN: d41d8cd98f00b204e9800998ecf8427e
Content-Type: application/json

{
    "areaCode": "Georgia"
}

5. 响应参数说明

成功响应 (200 OK)

字段名	类型	描述
code	Integer	状态码，0 表示成功
msg	String	提示信息
data	Array	城市数据列表
└ cityName	String	城市名称
└ cityCode	String	城市代码

响应示例

{
    "code": 0,
    "data": [
        {
            "cityName": "Albany",
            "cityCode": "Albany"
        },
        {
            "cityName": "Arlington",
            "cityCode": "Arlington"
        }
    ],
    "msg": ""
}