如何在REST API中正确使用Query Parameter获取指定数据？

1. 怎么知道有哪些可用参数？ #

所有像sfw=true这类参数，全在Jikan的官方API文档里写着。每个接口都会明确列出支持的参数、类型、合法取值和作用。比如getTopAnime接口，文档里会说明sfw是过滤成人内容的布尔参数，limit控制返回结果数量，type用来指定动画类型（movie、tv等），还有分页用的page参数等等。

2. 你写的两个URL都不对 #

• https://api.jikan.moe/v4/top/anime/type/movie：Jikan的top接口不支持用路径参数指定类型，这种写法不符合接口路由规则。
• https://api.jikan.moe/v4/top/anime?=query/type/movie：查询参数的格式是?参数名=参数值，正确写法应该是https://api.jikan.moe/v4/top/anime?type=movie。

3. 正确构造带参数的请求示例 #

比如要获取前20条全年龄段的热门电影动画，请求URL应该是：

https://api.jikan.moe/v4/top/anime?sfw=true&limit=20&type=movie

用fetch实现的代码：

const baseUrl = 'https://api.jikan.moe/v4/top/anime';
const queryParams = new URLSearchParams({
  sfw: true,
  limit: 20,
  type: 'movie'
});

fetch(`${baseUrl}?${queryParams}`)
  .then(res => res.json())
  .then(data => console.log(data))
  .catch(err => console.error(err));

用URLSearchParams能自动处理参数编码和拼接，比手动拼字符串更稳妥，避免出错。

4. 需要补的知识点 #

• REST API参数类型区分：搞清楚路径参数（比如/anime/123里的123，用来指定具体资源）和查询参数（用来过滤、排序、分页）的不同用法。
• API文档阅读：官方文档是使用API的唯一权威来源，学会看接口的参数列表、请求示例、响应结构，这是必备技能。
• HTTP查询参数规则：掌握?key=value&key2=value2的格式，以及不同工具（fetch、Axios等）里构造参数的方法。
• URL编码：如果参数值有特殊字符（比如空格、中文），需要编码，URLSearchParams会自动处理，手动拼接时要注意这一点。

内容的提问来源于stack exchange，提问作者mireumireu