Skip to content

获取国家列表 (Country List)

1. 接口描述

获取系统支持的所有国家/地区列表及其对应的 ISO 代码

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

2. 请求头规范 (Header)

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

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

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

3. 请求示例

http
POST /api/dynamic-proxy/geo/list-countries
Host: cueip.com
X-APP-ID: 10001
X-NONCE: 847291
X-TIMESTAMP: 1713164000
X-SIGN: 5d41402abc4b2a76b9719d911017c592
Content-Length: 0

4. 响应参数说明

成功响应 (200 OK)

字段名类型描述
codeInteger状态码,0 表示成功
msgString提示信息
dataArray国家数据列表
countryNameString国家/地区名称 (中文)
countryEnNameString国家/地区名称 (英文)
countryCodeStringISO 二位国家代码 (如 CN, US)

响应示例

json
{
    "code": 0,
    "msg": "success",
    "data": [
        {
            "countryName": "不丹",
            "countryEnName": "BT",
            "countryCode": "BT"
        },
        {
            "countryName": "东帝汶",
            "countryEnName": "TL",
            "countryCode": "TL"
        },
    ]
}