【笔记】API 接口设计核心笔记

API（应用程序编程接口）就像餐厅的菜单📋，它定义了服务提供方（厨房）和使用方（顾客）之间的交互规则。你不需要知道菜品如何制作，只需通过菜单点餐，就能获得所需的数据或功能。  

关键要点：  
1. **规范性**：遵循 RESTful 设计风格，用 HTTP 方法（GET/POST 等）和清晰路径（如 `/users`）表达操作。  
2. **易用性**：接口命名直观、参数明确，让调用者能“猜”出用法。  
3. **安全性**：通过身份验证（如 API Key）、数据加密（HTTPS）和访问控制保护接口。  
4. **稳定性**：版本管理（如 `/v1/users`）避免更新影响旧用户，并提供错误码提示问题。  

实际场景：  
开发天气小程序时，调用第三方天气 API。你只需发送城市名和认证密钥，就能获取 JSON 格式的天气数据，无需关心数据来源或计算逻辑，大幅提升开发效率⛅。  

刚整理完笔记，可能有理解不到位的地方，欢迎大家补充或指正交流！ 😊