如何解决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 举报,一经查实,本站将立刻删除。