如何解决Open API 3.0 是否支持前端和后端的不同代?
任何人都可以帮助我解决以下有关 Open API 3.0 规范的困惑。
POST /signup
端点(在前端)应该接受带有以下参数的 requestBody(JSON 格式):
{
"email": "user@user.com","password": "blaa","passwordConfirm": "blaa"
}
端点(在后端)应该返回如下所示的响应:
{
"email": "user@user.com","passwordConfirm": "blaa","handle": "username","createdAt": "2021-05-28T12:39:47.802Z"
}
响应中应该还有两个需要在后端设置的字段(createdAt
和 handle
)
这是我可以使用 Open API 3.0 指定的内容吗? 规范会是什么样子?
感谢您的帮助。
解决方法
有一个名为 readOnly
的字段,如果它设置为 true 意味着特定参数可以作为响应的一部分发送,但不应作为请求的一部分发送。
您可以查看 specification 中的 Read-Only and Write-Only Properties
部分。
例如,在您的情况下,它看起来像:
type: object
properties:
email:
type: string
password:
type: string
passwordConfirm:
type: string
handle:
type: string
readOnly: true
createdAt:
type: string
readOnly: true
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。