REST API 设计 REST API 用资源、方法和状态码表达接口语义。 核心要点 先定义资源、请求方法、状态码和错误格式。 给接口准备可复制的 curl 示例。 把认证、分页、限流和版本策略写进文档。 最小实践 bash 复制 npm install && npm run build 相关内容 API 开发教程 HTTP Reference Axios 教程 相关内容 API Key API Key 适合识别调用方,但不能替代用户级授权。 API Versioning API 版本管理用于兼容旧客户端并演进接口。 curl 调试 API curl 是排查 HTTP 请求、Header、状态码和响应体的基础工具。 JWT JWT 常用于无状态认证,包含 Header、Payload 和 Signature。 OAuth 2.0 OAuth 2.0 用于第三方授权登录和委托访问。 OpenAPI / Swagger OpenAPI 用机器可读格式描述 API,Swagger 常用于文档和调试界面。