0

我对大摇大摆还很陌生，希望能在好的学习资源上找到一些方向。

我有一个我正在整理的测试项目，我遇到了一些问题。

我收到一条错误消息，说我的“删除”块中的“参数”无效。从我在示例中看到的内容来看，这对我来说还不错。但显然我错过了一些东西。有任何想法吗？

swagger: "2.0"

info:
  version: "2"
  title: My Title
  description: Provides services for vacation rentals site
  termsOfService: Private
  contact:
    name: My Name
    url: www.myurl.com
    email: my@email.address
  license:
    name: MIT
    url: http://opensource.org/licenses/MIT
schemes:
  - http
host: myurl.com
basePath: /api

paths: 
  /guestbook:
    get:
      summary: Gets some persons
      description: Returns a list containing all persons.
      responses:
        200:
          description: A list of posts
          schema:
            type: array
            items:
              required:
                - firstName
              properties:
                firstName:
                  type: string
                lastName:
                  type: string
                email:
                  type: string
                comment:
                  type: string
    post:
      summary: Adds a comment to the guestbook
      description: Adds a comment to the guestbook
      parameters:
        - name: firstname
          in: formData
          required: true
          type: string
        - name: lastname
          in: formData
          required: true
          type: string
        - name: email
          in: formData
          required: true
          type: string
        - name: comment
          in: formData
          required: true
          type: string

      responses:
        201:
          description: Shows a successful post
        '405':
          description: Invalid input
  /guestbook/{id}:
    get:
      summary: Gets a single post
      description: Returns a single post
      operationId: getPost
      parameters:
        - name: id
          in: path
          description: ID of pet to fetch
          required: true
          type: integer
          format: int64
      responses:
        200:
          description: A list of posts
          schema:
            type: array
            items:
              required:
                - firstName
              properties:
                id:
                  type: number
                firstName:
                  type: string
                lastName:
                  type: string
                email:
                  type: string
                comment:
                  type: string
    delete:
      summary: Removes a post
      description: Removes a post
      operationId: deletePost
      parameters:
        - name: id
          in: path
      responses:
        200:
          description: Post has been removed
4

1 回答 1

1

您只需要像id在.delete /guestbook/{id} operationget /guestbook/{id}

delete:
  summary: Removes a post
  description: Removes a post
  operationId: deletePost
  parameters:
    - name: id
      in: path
      description: ID of pet to fetch
      required: true
      type: integer
      format: int64
  responses:
    200:
      description: Post has been removed

您还可以为 path 的所有操作定义一次此参数/guestbook/{id}：

/guestbook/{id}:
  parameters:
    - name: id
      in: path
      description: ID of pet to fetch
      required: true
      type: integer
      format: int64
  get:
    summary: Gets a single post
    description: Returns a single post
    operationId: getPost
    responses:
      200:
        description: A list of posts
        schema:
          type: array
          items:
            required:
              - firstName
            properties:
              id:
                type: number
              firstName:
                type: string
              lastName:
                type: string
              email:
                type: string
              comment:
                type: string
  delete:
    summary: Removes a post
    description: Removes a post
    operationId: deletePost
    responses:
      200:
        description: Post has been removed

如果需要学习如何编写 OpenAPI（fka.Swagger）规范文件，可以阅读我的编写 OpenAPI/Swagger 规范教程

于 2016-07-25T18:55:16.520 回答