按姓名搜索

按部分名称搜索

Name 端点用于搜索所有可用的国家。该端点允许访问 REST Countries API 的完整数据库。此端点的 URL 为 https://restcountries.com/v3.1/name/{name}。

请求参数

调用 Name 端点时，只需将 URL 中的 {name} 替换为想要查询的国家名称即可。

点击“编辑”按钮，修改下方查询中的国家名称。点击“运行”按钮，即可列出所有名称中包含查询关键词的国家。

1// 导入库
2import fetch from 'node-fetch';
3
4// 端点地址
5const endpointUrl = new URL('https://restcountries.com/v3.1/name/{{Country_Name}}');
6
7// 请求选项
8const options = {
9  method: 'GET'
10};
11
12// 执行 API 调用的函数
13async function searchByName() {
14  try {
15    const response = await fetch(endpointUrl, options);
16    printResponse(response);
17  } catch (error) {
18    printError(error);
19  }
20}
21
22// 调用函数
23searchByName();

在上述代码组件中：

• 第 2 行： 导入所需的库。
• 第 5 行： 将 Name 端点的基础 URL 赋值给 endpointUrl 变量。
• 第 8–10 行： 设置请求参数。
• 第 13–20 行： 创建一个执行 API 调用的函数。该函数尝试使用指定的 URL 获取数据并打印响应结果；若发生错误，则输出错误信息。
• 第 23 行： 调用执行 API 调用的函数。

响应字段

该 API 调用将返回一个 JSON 格式的响应，其中包含名称部分匹配查询条件的所有国家的详细信息。响应内容与 REST Countries API 概览 课程中介绍的信息一致。

按完整名称搜索

REST Countries API 提供了一个专门用于按完整名称搜索国家的端点。相比 Name 端点（返回名称部分匹配的国家），该端点更加精确。要使用 完整名称 端点，需在 API 请求 URL 中指定目标国家的完整名称，并将 fullText 查询参数设置为 true。该端点的 URL 为 https://restcountries.com/v3.1/name/{name}?fullText=true。

请求参数

在发起 API 调用时，需将 {name} 参数替换为希望查询的国家完整名称。

点击“编辑”按钮，修改下方查询中的国家名称。点击“运行”按钮，即可获取与查询名称完全匹配的国家的详细信息。

1// 导入库
2import fetch from 'node-fetch';
3
4// 端点地址
5const endpointUrl = new URL('https://restcountries.com/v3.1/name/{{Full_Name}}?fullText=true');
6
7// 请求选项
8const options = {
9  method: 'GET'
10};
11
12// 执行 API 调用的函数
13async function searchByFullName() {
14  try {
15    const response = await fetch(endpointUrl, options);
16    printResponse(response);
17  } catch (error) {
18    printError(error);
19  }
20}
21
22// 调用函数
23searchByFullName();

在上述代码组件中：

• 第 2 行： 导入用于发起 API 调用的必要库。
• 第 5 行： 将完整名称端点的基础 URL 赋值给 endpointUrl 变量。
• 第 8–10 行： 设置请求类型为 GET。
• 第 13–20 行： 创建一个执行 API 调用的函数。该函数尝试使用指定的 URL 获取数据并打印响应结果；若发生错误，则输出错误信息。
• 第 23 行： 调用执行 API 调用的函数。

响应字段

该 API 调用将返回一个包含与查询名称完全匹配的国家详细信息的 JSON 响应。响应内容与 REST Countries API 概览 课程中说明的信息一致。如果不存在名称完全匹配的国家，则返回状态码 404。