DEV Community
·
开发者必备的API基本术语高级词汇表
💡
原文英文，约700词，阅读约需3分钟。
📝
内容提要
本文简要概述了API开发中的基本术语，包括API、请求、响应和身份验证等概念，同时介绍了API协议、数据格式、设计模式及文档工具，帮助读者快速理解API生态系统的基础知识，促进深入探索。
🎯
关键要点
- API（应用程序编程接口）：构建和交互软件应用的规则和协议。
- 端点：API可以访问所需资源的特定URL。
- 请求：对API端点的调用。
- 响应：API处理请求后返回的数据。
- 有效载荷：请求体中发送的数据（例如，JSON、XML）。
- 头部：与API请求/响应一起传递的元数据。
- 速率限制：限制在给定时间内的API调用次数。
- 延迟：发出请求后获取API响应所需的时间。
- 版本控制：通过维护多个版本来管理API的变化。
- REST（表现层状态转移）：使用标准HTTP方法的架构风格。
- SOAP（简单对象访问协议）：使用XML交换结构化信息的协议。
- GraphQL：允许客户端请求特定数据的API查询语言。
- gRPC：一种高性能、语言无关的远程过程调用框架。
- WebSocket：用于实时双向通信的协议。
- JSON-RPC：以JSON编码的远程过程调用协议。
- API密钥：用于验证API请求的唯一标识符。
- OAuth：基于令牌的授权开放标准。
- JWT（JSON Web令牌）：用于安全传输信息的紧凑、URL安全的令牌。
- 基本身份验证：使用用户名和密码的简单HTTP请求方法。
- HMAC（基于哈希的消息认证码）：用于验证消息完整性和来源的方法。
- SSL/TLS：用于计算机网络上安全通信的协议。
- JSON（JavaScript对象表示法）：轻量级数据交换格式。
- XML（可扩展标记语言）：用于定义文档编码规则的标记语言。
- YAML（YAML不是标记语言）：人类可读的数据序列化格式。
- CSV（逗号分隔值）：用于表格数据的简单格式。
- HATEOAS（超媒体作为应用程序状态的引擎）：在响应中动态链接资源。
- 幂等性：确保重复调用具有相同效果（对PUT、DELETE很重要）。
- 分页：将结果分成可管理的块。
- 速率限制：控制API流量以防止滥用。
- 节流：控制API调用的处理速率。
- 错误处理：返回有意义的错误代码和消息（例如，HTTP 404、500）。
- OpenAPI/Swagger：定义和记录API的框架。
- Postman：用于API测试的工具。
- Curl：用于发出API请求的命令行工具。
- Fiddler：用于监控和调试API流量的工具。
- 网关：处理API流量、身份验证和监控的管理层。
- 中间件：连接和促进API通信的软件。
- 日志记录：跟踪API使用情况和问题。
- 监控：跟踪API性能和正常运行时间。
- 微服务：小型、独立可部署的服务。
- Webhooks：用于通知外部系统的事件驱动通信。
- API链：顺序调用多个API。
- SDK（软件开发工具包）：用于开发和与API交互的工具包。
- 缓存：存储响应以供重复使用（例如，使用HTTP Cache-Control）。
- API在现代开发中至关重要，理解这些关键术语为构建高效和安全的集成奠定基础。
❓
延伸问答
什么是API？
API（应用程序编程接口）是一组用于构建和交互软件应用的规则和协议。
API请求和响应是什么？
请求是对API端点的调用，响应是API处理请求后返回的数据。
什么是身份验证，常用的身份验证方式有哪些？
身份验证是确认用户身份的过程，常用方式包括API密钥、OAuth和基本身份验证。
REST和SOAP有什么区别？
REST是一种使用标准HTTP方法的架构风格，而SOAP是使用XML交换结构化信息的协议。
什么是速率限制，为什么重要？
速率限制是限制在给定时间内的API调用次数，重要性在于防止滥用和保护服务器资源。
API文档工具有哪些？
常用的API文档工具包括OpenAPI/Swagger和Postman。
➡️
