OpenAPI 规范连接被拒绝

Question

我的 OpenAPI 规格文件有问题。我正在尝试将公开的 url 调用到 'GET' 一个 ID，但每次我将服务转发到我的本地，然后尝试通过 API 文档发送请求时，我的连接被拒绝。我将不胜感激任何帮助。我期望的 ID 将采用 JSON 格式。下面是我的规格文件

openapi: "3.0.0"
info:
  version: 1.0.0
  title: Id Generator
servers:
   url: www.someurl.com
paths:
  /posts:
    get:
      summary: Get Id
      operationId: id
      tags:
        - posts
      responses:
        200:
          description: successful operation
          content:
            application/json:
              schema:
              $ref: "#/definition/Post"
        default:
          description: unexpected error
          content:
            application/json:
              schema:
              $ref: "#/definition/Error"

definition:
    Post:
    type: object 
    properties:
        id:
          type: string
    Error:
      properties:
        id:
          type: string

Answer 1

截至 2017 年 6 月 21 日，OpenAPI 规范 3.0 尚未发布，Swagger UI 尚不支持 OpenAPI 3.0，因此您的示例可能无法运行。请关注 Swagger UI releases 页面以了解何时支持 OpenAPI 3.0。

此外，您需要修复规范中的错误，使其成为有效的 OpenAPI 3.0 规范：

servers是数组，所以改成：

servers:
  - url: http://www.someurl.com

必须引用响应状态码："200"或'200'.

在架构下缩进 $ref：

              schema:
                $ref: "#/definition/Post"
              ...
              schema:
                $ref: "#/definition/Error"

将 definition 更改为 components->schemas 并修复 Post:

的缩进

components:
  schemas:
    Post:
      type: object 
      properties:
        id:
          type: string
    Error:
      properties:
        id:
          type: string

OpenAPI 规范连接被拒绝

OpenAPI Spec Connection Refused

swagger

swagger-2.0

openapi