OpenAPI / Swagger OpenAPI 用机器可读格式描述 API，Swagger 常用于文档和调试界面。 核心要点 先定义资源、请求方法、状态码和错误格式。 给接口准备可复制的 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 用于第三方授权登录和委托访问。 API 分页 分页用于控制列表接口返回规模，避免一次返回过多数据。
