6.2. OpenAPI 操作与 API 供应商集成流的关系

API 供应商集成的 OpenAPI 文档定义 REST API 客户端可以调用的操作。每个 OpenAPI 操作都有自己的 API 供应商集成流。因此，每个操作也可以拥有自己的 REST API 服务 URL。每个 URL 由 API 服务的基本 URL 和子路径可选定义。REST API 调用指定一个操作的 URL，用于触发该操作的流执行。

您的 OpenAPI 文档决定了哪个 HTTP 动词（如 GET、POST、DELETE 等）您可以在调用 REST API 服务 URL 中指定。调用 API 提供程序 URL 的示例是 在尝试 API 供应商快速入门示例的说明 中。

您的 OpenAPI 文档还决定操作可以返回的 HTTP 状态代码。操作的返回路径只能处理 OpenAPI 文档定义的响应。例如，基于其 ID 删除对象的操作可能会定义这些可能的响应：

"responses": {
  "204": {
           "description": "Task deleted"
         },
  "404": {
           "description": "No Record found with this ID"
         },
  "500": {
            "description": "Server Error"
        }
}

编辑 OpenAPI 文档时的注意事项：