网络 · 2026年1月16日

API请求的URL,是怎么组成的?

通常来讲,一个完整的API请求URL由scheme,host,path,path parameters和query parameters组成:

https://abc.baidu.com/outurl/v1/station/{MainUserID}?lang=en&page=3
\___/   \___________/\________________/\___________/\_____________/
scheme      host           path            path         query
                                          params        params 
JavaScript

scheme:协议方案;常见的如:https、http、wss等

host:主机; 通常是域名,也可以是 IP 地址,有时还包含端口号;

path:路径;又称为API端点、Endpoint; 表示服务器上的资源路径,由 / 分隔的一串字符串。

path params:路径参数;在严格的 URL 标准里,并没有一个单独叫 “path params” 的组件;一般是指路径中像变量一样的部分,例如:/users/{id} 中的 id,但不是 ?key=value 这种 query 参数,而是嵌在 path 里的 “占位符”;

query params:查询参数;以 ? 开头,& 分隔的 key=value 键值对。常用于过滤、分页、排序等。