实现自定义HTTP方法是否有问题？

我们的网址格式如下

/ instance / {instanceType} / {instanceId}

您可以使用标准的HTTP方法来调用它：POST，GET，DELETE和PUT。但是，我们还有其他一些操作，例如“另存为草稿”或“制作”

我们认为我们可以只使用自定义HTTP方法，例如：DRAFT，VALIDATE，CURATE

我认为这是可以接受的，因为标准说

“下面定义了HTTP / 1.1的一组常用方法。尽管可以扩展此组，但是不能假定其他方法可以为单独扩展的客户端和服务器共享相同的语义。”

像WebDav这样的工具会创建一些自己的扩展。

定制方法是否会遇到问题？我正在考虑代理服务器和防火墙，但是任何其他令人关注的方面都欢迎。我应该放心一点，只是拥有URL参数，例如action = validate | curate | draft？

之一的HTTP的基本限制和所述 REST的中央设计特征是一个统一的接口所提供的（除其他外）一个小的，固定的一套普遍适用于所有资源的方法。统一的界面约束具有许多优点和缺点。我在这里自由引用菲尔丁的话。

统一的界面：

• 更简单。
• 使实现与提供的服务脱钩。
• 允许分层体系结构，包括HTTP负载平衡器（nginx）和缓存（清漆）之类的东西。

另一方面，一个统一的接口：

• 因为信息是以标准化形式而不是特定于应用程序需求的形式传输的，所以降低了效率。

权衡是“针对Web的常见情况设计的”，并允许构建一个大型的生态系统，该生态系统为Web体系结构中的许多常见问题提供了解决方案。坚持统一的界面将使您的系统能够从该生态系统中受益，而破坏该生态系统将使其变得如此困难。您可能想要使用像nginx这样的负载均衡器，但是现在您只能使用了解DRAFT和CURATE的负载均衡器。您可能想要使用像Varnish这样的HTTP缓存层，但是现在您只能使用理解DRAFT和CURATE的HTTP缓存层。您可能想寻求某人的帮助来解决服务器故障，但没有人知道CURATE请求的语义。可能难以更改您首选的客户端或服务器库，以了解并正确实现新方法。等等。

正确的^*表示方式是在资源（或相关资源）上进行状态转换。您无需草稿，您可以将其draft状态转换为，true也可以创建draft包含更改并链接到以前的草稿版本的资源。您无需创建帖子，而是将其curated状态转换为，true或创建curation将帖子与策划该帖子的用户链接的资源。

^{*正确，因为它最紧密地遵循REST体系结构原则。}

我希望将它们设计为子资源，在其上执行POST请求。

假设您有的资源/instance/type/1，我将以该资源的表示形式传达一些指向可以在资源上执行的“操作”的链接，例如/instance/type/1/draft和/instance/type/1/curate。在JSON中，这可能很简单：

{
    "some property":"the usual value",
    "state": "we can still inform the client about the current state",
    "draft": "http://server/instance/type/1/draft",
    "curate": "http://server/instance/type/1/curate"
}

这样，在对curate成员提供的链接的POST请求期间，客户端可以非常明确地了解需要发生的情况。此处发布的资源可能包含详细说明可能导致状态转换的事件的参数。

采用“天真”的方法来在资源上的可能状态之间移动的缺点是无法捕获导致这些转换的事件。

状态转换通常是响应特定事件而发生的，我宁愿捕获那些事件，也不愿让客户端决定某些事物现在处于特定的“状态”。这也使验证更加困难。另外，除非您也描述州本身，否则您将无法捕获任何“参数”。然后，当某些代码在不进行真实状态转换的情况下更改了代码而又需要进行验证时，一切就变得很棘手，整个过程很快就变得一团糟。

我认为自定义HTTP方法是实现实体操作的最佳方法。将动作添加到实体主体（POST）似乎不正确，它不是您的实体的一部分（尽管结果可能保存在其中）。同样，使用自定义HTTP方法，代理可以确定其动作而无需解析实体主体。

就像CRUD，您总是想实现这些功能，但是也有自己的一套特定操作（针对每个实体）。我真的不知道扩展这些内容会有什么问题。

另外@Rein Henrichs“您不草稿，将其草稿状态转换为true或创建草稿资源”对我来说似乎是错误的。一个drafts属性将被用于持久保存的状态，而不是进行转换的。动作甚至不一定会导致“状态”，也不一定会保存在属性中。为每个状态/转换创建一个单独的实体似乎更加模糊。尝试保持对实体的相同引用（URI）。