资源具有多个状态时如何设计REST API

Question

我将设计用于我的Web应用程序中的事件报告的REST API。 事件具有三个状态。 即调查事件，解决和事后调查。 我为每个状态使用三个数据库表。我想设计用于创建数据库新事件的rest api。 这里的新事件是指事件处于调查状态。

我尝试了两种设计Rest API的方法。 在第一种方法中，我将三种状态视为子资源。

POST - /incident/investigation
POST - /incident/resolved
POST - /incident/postmortem

在第二种方法中，我认为在POST方法的http响应中传递事件状态。

POST-/incident

设计REST API的最佳方法是什么？

Answer 1

REST API应该标识资源，因此您将使用/incident/123符号来表示事件编号123。并且/incident/123/status将是该特定事件的当前状态。

由于每个事件仅处于一个状态，因此您不会遇到“多个状态”问题。