cURL
curl "https://api.ruseo.cn/api/country?type=name&q=china&fullText=false&fields=name%2Cflags%2Cpopulation"
01
基本信息
接口调用前需要确认的核心配置。
接口地址
/api/country请求方式GET,POST
返回格式JSON
调用权限免费
ApiKey不需要
创建时间2026-05-26
脚本路由
country
02
请求参数说明
必填参数必须传入，示例值可直接用于联调。
💡 统计个人调用次数
免费API不强制要求API Key，但如果您希望统计个人调用次数，请在请求时附加参数 key=您的API_KEY。
注册账号后即可获得API Key。
| 参数名 | 必填 | 类型 | 说明 | 示例值 |
|---|---|---|---|---|
key |
否 | string | 可选参数：携带此参数可统计您的个人调用次数。请注册账号获取API Key。 | YOUR_API_KEY |
type |
否 | string | 查询类型：name(名称)/capital(首都)/region(大洲)/alpha(国家代码)/currency(货币)/language(语言) | name |
q |
是 | string | 查询值（国家名/首都/大洲名/代码/货币代码/语言名） | china |
fullText |
否 | string | 完全匹配，仅type=name时有效，true/false | false |
fields |
否 | string | 过滤返回字段，逗号分隔（如name,flags,population） | name,flags,population |
03
示例代码
优先使用示例地址测试请求参数是否正确。
示例请求
https://api.ruseo.cn/api/country?type=name&q=china&fullText=false&fields=name%2Cflags%2Cpopulation
PHP
$url = 'https://api.ruseo.cn/api/country?type=name&q=china&fullText=false&fields=name%2Cflags%2Cpopulation';
$response = file_get_contents($url);
$data = json_decode($response, true);JavaScript
fetch('https://api.ruseo.cn/api/country?type=name&q=china&fullText=false&fields=name%2Cflags%2Cpopulation')
.then(res => res.json())
.then(data => console.log(data));
04
返回说明
实际返回内容以接口脚本处理结果为准。
返回示例
{
"code": 0,
"msg": "success",
"data": {
"route": "country",
"example": true
}
}返回参数说明
| 参数名 | 类型 | 说明 | 示例值 |
|---|---|---|---|
code |
integer | 状态码，0=成功 | |
data.query |
string | 查询值 | |
data.type |
string | 查询类型 | |
data.count |
integer | 匹配国家数量 | |
data.countries |
array | 国家信息列表 | |
data.countries[].name |
string | 国家通用名 | |
data.countries[].cca2 |
string | 2位国家代码 | |
data.countries[].capital |
array | 首都 | |
data.countries[].region |
string | 大洲 | |
data.countries[].population |
integer | 人口 | |
data.countries[].flags |
object | 国旗图片链接 | |
data.countries[].currencies |
array | 货币信息 | |
data.countries[].languages |
array | 语言信息 | |
响应结果
◔ --
点击左侧“发送请求”查看结果...