获取地区列表 (Region List)

1. 接口描述

根据国家 ISO 代码，获取该国家支持的地区列表。

• 请求方式：POST
• 接口地址：https://api.cueip.com/api/dynamic-proxy/geo/list-areas
• 内容类型：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 格式的对象。

参数名	类型	是否必填	描述	示例
countryCode	String	是	ISO 二位国家代码	"EG"

4. 请求示例

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

{
    "countryCode": "US"
}

5. 响应参数说明

成功响应 (200 OK)

字段名	类型	描述
code	Integer	状态码，0 表示成功
msg	String	提示信息
data	Array	地区数据列表
└ areaName	String	地区名称
└ areaCode	String	地区代码

响应示例

{
    "code": 0,
    "data": [
        {
            "areaName": "乔治亚州",
            "areaCode": "Georgia"
        },
        {
            "areaName": "亚利桑那州",
            "areaCode": "Arizona"
        },
        {
            "areaName": "伊利诺伊州",
            "areaCode": "Illinois"
        },
    ],
    "msg": ""
}