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

Open API 3.0 是否支持前端和后端的不同代?

如何解决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"
    }

响应中应该还有两个需要在后端设置的字段(createdAthandle

我的目标是生成应该输出不同代码的前端和后端:

  • 前端:电子邮件、密码、密码确认
  • 后端:电子邮件、密码、密码确认、句柄、createdAt

这是我可以使用 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 举报,一经查实,本站将立刻删除。