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