本文探讨了区分可靠、可维护接口与令人沮丧接口的核心API概念。大多数工程师每天都在使用API——发送请求并读取JSON——但设计他人可以依赖的API需要掌握HTTP基础，如方法、状态码、请求格式和响应结构。除了基础之外，开发者必须根据系统需求在REST、GraphQL、gRPC、Webhooks和WebSockets之间做出选择。关键的设计决策，包括命名规范、分页、版本控制、错误处理和向后兼容性，决定了长期的成功。安全要求谨慎实施API密钥、OAuth、JWT、作用域和权限——正确处理这些可以防止代价高昂的漏洞。可靠性特性，如超时、重试、幂等性、速率限制和缓存在压力下变得至关重要。随着API的扩展，支持性基础设施也很重要：清晰的文档、完善的规范、可观测性和契约测试能够建立团队信任。轮到你了：在你的经验中，最容易被忽视的API概念是什么？