如何RESTful发送HTML表单？

Question

我有一个名为'facts'的资源集合的URI，以及该集合中每个'fact'资源的URI。

我相信，应该使用GET请求创建新“事实”的表单，但我无法确定应该使用哪个URI。

对集合URI的GET应返回“事实”资源URI的列表。 每个'事实'URI应该返回其内容作为对GET的响应。 当然，实际的'事实'创建将是POST（或PUT，具体取决于具体情况）。

我看到一些选项，但似乎没有一个令人满意：

1. 添加“事实”URI将引用的“事实形式”URI。 对此URI的GET提供HTML表单。 仅仅为了描述资源而拥有另一个资源似乎是错误的。
2. 对'fact'URI进行的POST而不在头文件中包含任何表单数据将返回该表单。 然后在用户填写表单后，它将使用表单数据POST，并创建新的“fact”资源。 这似乎是一种更糟糕的方法。
3. 不要通过电汇发送表格，而是将其作为API的一部分包含在内。 这似乎是RESTful，因为REST API应该描述媒体类型，并且可以从“事实”类型的描述中创建表单。 实施起来很奇怪。 也许REST服务与常规网站是分开的，因此实际的HTML表单请求与REST API不同。
4. 包含HTML表单作为“事实”URI响应的一部分。

为了澄清，我正在尝试遵循Roy Fielding所规定的真正的REST架构，而不是半生不熟的RPC冒充REST。

编辑：我开始认为＃3正在发挥作用。

edit2：我认为解决方案是以CRUD方式定期进行非REST HTML导航，然后前端根据需要进行AJAX REST调用（或者后端对其REST API进行内部调用）。

我需要正确执行此服务的REST部分的原因是我希望以后允许其他非HTML客户端与其进行交互。

Answer 1

在我看来，唯一干净的RESTful答案是1和3。

在我看来，资源的描述是它自己的资源。 问题是您是否希望通过应用程序的API访问此资源，或者您是否希望将其作为API本身的一部分。

对于1，似乎RESTful使URI像这样：

获取/事实 - >所有事实GET / facts / 1 - >返回事实1（显然id可能是一个单词或其他东西）GET / facts / create - >返回一个适合创建事实的表单POST / fact - >添加事实

Answer 2

我觉得你有点过分复杂了。 Web浏览器不是一个完美的REST客户端，因此您无法拥有完美的RESTful解决方案。 在完美的世界中，您根本不需要表单，因为Web浏览器会知道您的媒体类型并构建表单本身。

同时，我建议你只使用大多数REST框架在资源上调用额外的“视图”来返回一个表单：
例如/your/collectionresource?view=form ，或/your/collectionresource;form