代码之家  ›  专栏  ›  技术社区  ›  Francisco Hanna Mackay

restfulapi的请求后副作用

  •  0
  • Francisco Hanna Mackay  · 技术社区  · 6 年前

    POST /emails/subscribers/:subcriberId 存在允许客户端向由标识的订户发送电子邮件的终结点 subscriberId .

    现在,出现了一个新的用例,可以将电子邮件发送给未注册的订户。相反,电子邮件及其名称将在请求正文中指定。

    我正在考虑实现以下端点:

    POST /emails
    {
        // email content and metadata
        "receiverName": "John Smith",
        "receiverEmail": "john@example.com"
    }
    

    使用接收器的数据 副作用 发送电子邮件的方法。

    这是一个可以接受的安静的做法吗?

    笔记

    • 订户也通过电子邮件进行唯一标识。
    0 回复  |  直到 6 年前
        1
  •  0
  •   VoiceOfUnreason    6 年前

    这是一个可以接受的安静的做法吗?

    对。

    HTTP约束请求和响应的语义。实现的副作用由服务器决定。

        2
  •  0
  •   RAM    6 年前

    解决问题的一个方法是提供一个 POST /emails 其契约支持两种用例的端点:向订户和非订户发送电子邮件。

    关于你的API,我建议你重新考虑你的设计,因为它违反了一些基本的设计原则。例如:

    • 集合资源名称应为复数形式(即。, /subscribers )