URL 结构 · 路径与参数
英文：url structure（逐字母读 U-R-L）
后端与数据库难度：入门 ★
🗣️一句话大白话
一个网址分两段：路径说明「要什么资源」（/api/notes/42），参数补充「要什么条件」（?page=2&sort=time）。接口设计的可读性，全看这两段规划得好不好。
🎬真实场景
同样查笔记：/api/getNoteList?type=mine&page=2 和 GET /api/notes?page=2 ——第二种是标准风格：用路径表示资源、用参数表示条件。让 AI 按这个风格设计接口，代码更整洁。
📮你可以这样说
「「接口按 REST 风格设计：资源用名词路径（/api/notes、/api/notes/42），动作由方法表达（GET 查、POST 建、PUT 改、DELETE 删），筛选参数放查询字符串。」」
⚠️边界与常见误解
- ▸路径里放资源、参数里放条件，别混着来
- ▸带敏感信息的参数（token）别放 URL——URL 会被日志记录
- ▸接口 URL 一旦对外使用就不要随意改结构，改了就是「接口版本」问题