RESTful 接口规范是什么?
参考答案
以资源为中心、用 HTTP 语义表达操作的接口风格:
- URL 表示资源,用名词复数:
/users、/users/1,不用动词; - HTTP 方法表达动作:GET 查询、POST 新建、PUT 全量更新、PATCH 局部更新、DELETE 删除;
- 状态码语义化:200/201/204、301/304、400/401/403/404/409/422、500;
- 无状态:每次请求自带认证信息,服务端不保存会话;
- 统一响应结构:如
{ code, message, data }(业务码与 HTTP 码分开); - 过滤/分页/排序用 query:
?page=1&size=20&sort=-createdAt; - 版本管理:
/v1/users或 Accept 头; - 幂等性:GET/PUT/DELETE 幂等,POST 非幂等。
实践补充:错误统一格式、限流、HATEOAS 可选、避免在 URL 暴露敏感信息。