如何获取API接口支持的所有可传入查询参数列表

公开API全量查询参数获取方法 #

• 查找结构化接口文档：优先尝试访问API服务域名下的/openapi.json、/swagger.json、/api/v1/docs这类通用文档路径，正规公开API的结构化文档会完整列出所有支持的请求参数、取值范围、校验规则。
• 查阅项目开源代码：如果API所属项目开源，直接定位到对应接口的参数校验、请求处理逻辑，就能拿到100%准确的支持参数列表，也能直接看到每个参数的合法取值要求。
• 抓包官方前端请求：打开API对应的官方站点页面，触发你需要的筛选操作，在浏览器开发者工具的网络面板里查看官方发起的请求参数，就能拿到实际生效的参数名和取值格式。
• 小范围枚举测试：如果以上方法都不可行，可以根据需求匹配常见参数命名（比如地图类参数常用map、map_id、mapType等）逐个测试，对比返回结果差异确认有效参数。

你当前map_type参数失效的排查思路 #

你使用的请求如下：
GET("https://aoe2.net/api/matches?game=aoe2de&count=1000&since=1632744000&map_type=12")
常见失效原因按优先级排序：

1. 参数名不匹配：接口实际支持的地图筛选参数可能不是map_type，建议参考官方前端的实际调用参数确认正确命名。
2. 参数取值不合法：12可能不是该接口支持的合法地图类型编码，或是该参数需要和对局类型、段位等其他参数搭配使用才会生效。
3. 服务端未实现该筛选逻辑：部分未正式开放的参数不会在文档中提及，且服务端暂未做对应的过滤处理，因此加不加参数返回结果无差异。

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