[DEMO] 国家地区基础信息数据

筛选保留历史正则表达式与不区分大小写行为；不同筛选条件同时满足，同一 currencies 或 languages 中逗号分隔的值任一匹配即可。未提供条件时查询可用目录；合法无匹配返回空数组。可选元数据允许 null，不代表实时人口、政策或领土认定。
按国家及地区代码查询基础资料。
按名称筛选目录中的国家及地区。
按电话区号筛选，便于整理号码背景资料。
按洲代码筛选，便于分组展示。
按币种筛选，便于制作币种对应资料。
按语言筛选，便于制作语言对应资料。
同一币种或语言参数支持逗号分隔的多个筛选值。
可组合多个条件，整理同时符合条件的资料。
返回两位与三位代码，便于资料对照。
返回名称、本地名称和首都等可用元数据。
以数组返回匹配结果，适合制作国家选择列表。
返回实际匹配条数，合法无匹配时返回空数组。

当前接口契约

接口详情：https://www.gugudata.com/api/details/metacountry

公开 Demo 用于查看调用方式和响应结构，返回范围以示例参数为准。

正常响应

HTTP 200，application/json。

字段	类型	说明
dataStatus	object
dataStatus.requestParameter	string
dataStatus.statusCode	integer
dataStatus.status	string
dataStatus.statusDescription	string
dataStatus.responseDateTime	string
dataStatus.dataTotalCount	integer
data	object[]

业务状态说明

业务状态码	业务状态码解释	备注
400	参数错误	HTTP 400
500	数据依赖失败	HTTP 500

返回响应

🟢200成功

application/json

业务码 200 成功。筛选保留历史正则表达式与不区分大小写行为；不同筛选条件同时满足，同一 currencies 或 languages 中逗号分隔的值任一匹配即可。未提供条件时查询可用目录；合法无匹配返回空数组。可选元数据允许 null，不代表实时人口、政策或领土认定。

Bodyapplication/json

示例

{
  "dataStatus": {
    "requestParameter": "languages=zh",
    "statusCode": 200,
    "status": "SUCCESS",
    "statusDescription": "successfully / 成功",
    "responseDateTime": "2026-10-13 16:29:03",
    "dataTotalCount": 2
  },
  "data": [
    {
      "alphaTwoCode": "CN",
      "emoji": "🇨🇳",
      "alphaThreeCode": "CHN",
      "name": "China",
      "nativeName": "中国",
      "phonePrefix": "86",
      "continent": "Asia",
      "capital": "Beijing",
      "currencies": "CNY",
      "languages": "zh"
    },
    {
      "alphaTwoCode": "SG",
      "emoji": "🇸🇬",
      "alphaThreeCode": "SGP",
      "name": "Singapore",
      "nativeName": "Singapore",
      "phonePrefix": "65",
      "continent": "Asia",
      "capital": "Singapore",
      "currencies": "SGD",
      "languages": "en,ms,ta,zh"
    }
  ]
}

🟠400参数错误，业务码 400。公共鉴权、额度与限流保留现有契约。

🔴500数据依赖失败，业务码 500。公共鉴权、额度与限流保留现有契约。

当前接口契约

正常响应

业务状态说明

请求参数

请求示例代码

返回响应

[DEMO] 国家地区基础信息数据

当前接口契约#

正常响应#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

正常响应

业务状态说明