REST API 简介 rest.api

在开始介绍 REST API 之前，让我们看看 API 是什么。

什么是 API？

API 是 Application Programming Interface 的首字母缩写，它是一种软件中介，允许两个应用程序相互通信。 现在，让我们看看什么是 REST API

什么是 REST API？

REpresentational State Transfer (REST) 是一种架构风格，它定义了一组用于创建 Web 服务的约束。 REST API 是一种无需任何处理即可以简单灵活的方式访问 Web 服务的方式。 通过 REST API 完成的所有通信仅使用 HTTP 请求。

RESTAPI 是如何工作的？

REST API 的工作方式几乎与任何网站相同。 客户端向服务器发起调用，并通过 HTTP 协议接收回数据。 您还可以使用它们提供通过 Web 浏览器使用请求标头、请求正文、响应正文、状态代码等来访问客户端所需的服务器上可用资源的方法。

HTTP 方法

HTTP 方法或 HTTP 动词构成了统一接口约束的主要部分，其次是 REST，它确定必须遵循哪些操作才能获取请求的资源。 最常见的方法包括 GET、POST、PUT 和 DELETE。

• GET 检索资源。
• POST 向服务器提交新数据。
• PUT 更新现有数据。
• DELETE 删除数据。 动词映射到 CRUD 操作。

优雅地处理错误并返回标准错误代码

常见的错误 HTTP 状态代码包括：

• 400 Bad Request — 这意味着客户端输入验证失败。
• 401 Unauthorized - 这意味着用户无权访问资源。 它通常在用户未通过身份验证时返回。
• 403 Forbidden - 这意味着用户已通过身份验证，但不允许访问资源。
• 404 Not Found — 这表示没有找到资源。
• 500 内部服务器错误 — 这是一般的服务器错误。 它可能不应该明确抛出。
• 502 Bad Gateway — 这表示来自上游服务器的无效响应。
• 503 Service Unavailable - 这表明服务器端发生了意外情况（可能是服务器过载，系统某些部分发生故障等）。

最佳 REST 客户端和测试工具

昂首阔步

Swagger 是一个 API 测试工具，它允许用户直接从开放 API 规范开始他们的功能、安全和性能测试。 一些优点：

• 支持 API 文档、开发、设计和测试。
• Swagger 为 OpenAPI 规范提供了许多开源功能。

邮递员 REST 客户端

使用 Postman，您可以监控 API、创建自动化测试、执行调试和运行请求。 一些优点：

• 流畅的自动化测试。
• 共享办公功能，便于共享和管理。
• 支持 Swagger 和 RAML 文件。

卡塔隆工作室

Katalon Studio 提供了一个公共场所来创建和执行 API/Web 服务、UI 功能和移动测试。 一些优点：

• 拥有最安全的断言库之一。
• 这是一个完整的包和框架。
• 支持数据驱动的方法。