微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

Swagger API 描述不应具有其他属性

如何解决Swagger API 描述不应具有其他属性

我有如下所述的 swagger API 描述 (yaml / v 3.0)。我收到错误 路径结构错误。/AanwezigLeden/Aanmelden.post.requestBody.content.application/json.schema 不应该有额外的属性 附加属性:allOff

我想要的是一个 post 方法的 API 描述,它的对象是指定的 oper_aanwezig_leden,还有一个附加字段作为主体。

    /AanwezigLeden/Aanmelden:
        post:
          summary: Aanmelden van het lid als aanwezig. 
          requestBody:
            description: Lid data
            required: true
            content:
              application/json:
                schema:
                  allOff:
                  - ref: '#/components/schemas/oper_aanwezig_leden' 
                  - type: string
                    name: TIJDSTIP
                    description: Tijdstip van de aanmelding. Indien afwezig,huidige tijd. ISO8601
                    required: false
          responses:
            200:
              description: "OK,data succesvol aangepast"
              content:
                application/json:
                  schema:
                    $ref: '#/components/schemas/oper_aanwezig_leden' 
            401:
              description: "Niet geautoriseerd,geen schrijfrechten"  
            404:
              description: "Data niet gevonden"        
            405:
              description: "Methode niet toegestaan,input validatie error"  
            406:
              description: "Niet aanvaardbaar,input ontbreekt"            
            500:
              description: "Data verwerkingsfout,bijv onjuiste veldwaarde (string ipv integer)" 

解决方法

这促使我解决了这个问题。然而,还有更多的错别字

  /AanwezigLeden/Aanmelden:
    post:
      summary: Aanmelden van het lid als aanwezig. 
      requestBody:
        description: Lid data
        required: true
        content:
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/oper_aanwezig_leden_in' 
              - type: object
                properties:
                  TIJDSTIP:
                    description: Tijdstip van de aanmelding. Indien afwezig,huidige tijd. ISO8601
                    type: string
                    format: date-time 
                    example: "2017-07-21T09:32:28Z"   

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。