更新资源和创建关联对象的RESTful方法

Question

我正在为提供临床数据分析的服务设计一个REST风格的API。API允许用户创建病人资源。此资源为服务器端分析提供输入数据。

创建病人既不安全也不幂等(服务器分配ID)，所以使用POST，POST Patients

病人资源可能很大，所以它有子资源，例如药物，可以更新。更新药物是幂等的，因为整个医疗系统将被替换，所以使用PUT。

临床分析是通过请求POST /Patients/{patientId}/analysisResults触发的。或者，用户可以请求在POST /Patients请求的响应中返回分析结果；这将节省额外的HTTP往返。

我的问题是:用户希望获得Patient/Medications更新(PUT)响应中包含的分析结果--这是可以理解的，因为他们不想再次请求检索结果。因此，对于病人资源，PUT Patient/Medications是幂等的，但不是所有的资源，因为将创建一个新的analysisResults子资源。我是否应该：

• ( a)使用PUT启用此操作。
• ( b)用一个员额来启用这一点。
• ( c)坚持需要单独调用才能创建新的analysisResults，即使这会增加最终用户的总体响应时间？

Answer 1

如果您希望保持RESTful，则可选择C。

选项A和B很可能会削弱REST设计给您的属性，缓存是直接出现在脑海中的。

如果这是基于HTML的，则响应将包含一个指向analysisReport资源的链接，以允许用户将应用程序驱动到有用的位置。