4.2. OpenAPI 文档示例:Petstore API


要从原始源读取规格,请参阅 OpenAPI 规格

在 OAS 网站上,定义了 API 的 OpenAPI 文档的多个示例。如果您想通过示例了解,可以按照 OAS API 团队的 Petstore API 示例进行操作。

Petstore API 是一个极其简单的 API。它被称为学习工具,不适用于生产环境。

Petstore API 方法

Petstore API 由 4 种方法组成:

  • GET /api/pets - 返回系统中的所有片断
  • POST /api/pets - 在存储中创建新的片断
  • GET /api/pets/{id} - 基于单个 ID 返回 pet
  • DELETE /api/pets/{id} - 根据 ID 删除一个片断

Petstore API 与 3scale 集成,因此您必须添加额外的参数进行验证。例如,通过用户密钥身份验证方法,API 使用者必须将 user key 参数放在各个请求的标头中。有关其他验证方法的详情,请参考验证模式

用户密钥参数

user_key: {user_key}

user_key 将由 API 用户在其请求中的 API 发送到您的 API。API 用户将获得 3scale 管理员开发人员门户的密钥。在收到密钥时,3scale 管理员必须使用 Service Management API 对 3scale 执行授权检查。

OpenAPI 规格的更多信息

对于 API 用户,在 cURL 调用中代表的 API 文档类似如下:

curl -X GET "http://example.com/api/pets?tags=TAGS&limit=LIMIT" -H "user_key: {user_key}"
curl -X POST "http://example.com/api/pets" -H "user_key: {user_key}" -d "{ "name": "NAME", "tag": "TAG", "id": ID }"
curl -X GET "http://example.com/api/pets/{id}" -H "user_key: {user_key}"
curl -X DELETE "http://example.com/api/pets/{id}" -H "user_key: {user_key}"
Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.