7 hours ago
- RESTful API是REST架构风格的完整实现，通过超媒体达到理查森成熟度模型第3级。
- 超媒体（HATEOAS）通过在响应中包含链接使API自描述且可导航，以便客户端发现资源。
- RESTful API的六条规则包括：不依赖单一协议、不改变协议、关注媒体类型、不假设URI结构、避免资源类型、以及从根资源书签开始。
- 应记录媒体类型（如application/vnd.myshop.product+json）而非URI，使客户端能够根据Content-Type决定操作。
- 错误应遵循RFC 9457（HTTP API的问题详情），使用application/problem+json并包含标准化字段。
- 版本控制最好通过Accept头协商而非URI处理，例如application/vnd.dream.v2.1+json。
- 分页包含元数据（total、page、perPage、hasNext、hasPrevious）和可导航链接（self、next、first、last）。