Skip to content

获取国家列表 (Country List) ​

1. 接口描述 ​

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

  • 请求方式:POST
  • 接口地址:https://api.cueip.com/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: api.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"
        },
    ]
}