使用 Swagger 响应 header 405 进行错误测试 API

Question

所以我对创建 API 文档还很陌生，我在通过 swagger UI 创建新条目时遇到了一些困难。我不断收到 405 响应。我不知道问题出在哪里，我已经变成代码盲了。 link 到 API 如下。任何指针将不胜感激。 https://swaggerhub.com/apis/Sharper-Web-Dev/test/1.0.0

Answer 1

您的定义将 SwaggerHub 的模拟服务器 (virtserver.swaggerhub.com) 指定为目标服务器。模拟服务器根据 API 定义中定义的 responses 生成响应。 POST /charity 仅定义 405 响应，这就是为什么模拟 returns 405.

要获得 "normal" 响应，您需要定义 200 OK 或 201 Created 响应，并添加描述所需 JSON结构。

paths:
  /charity:
    post:
      ...
      produces:
        - application/json
      parameters:
        ...
      responses:
        200:
          description: OK
          schema:
            $ref: "#/definitions/MyResponseSchema"
        405:
          description: "Invalid input"  

有关详细信息，请参阅 SwaggerHub 文档中的 How Response Mocking Works。