糟糕的 RESTful 设计示例

Question

我希望了解糟糕的 RESTful 设计的后果。例如，我听说在 REST 端点中使用动词而不是名词是不好的做法。我想知道在这种情况下使用动词的后果。

Answer 1

基本上，不遵循 RESTful 设计的后果是您没有实现 RESTful 服务。就是这样。

目前，我不知道发布非 RESTful 服务后有任何原子爆炸。

顺便说一句，如果您的文档声明您的 API 是 RESTful 并且您不使用 URI 作为资源标识符，那么您在 URI 中使用动词（也就是说，它们不是指向资源而是操作）并且您不遵循将 API 视为 RESTful 的更多规则，您违背了 RESTful API 的目的，因为它应该构建在 convention over configuration 范式之上，并声明 我是 RESTful 而你不是 RESTful 不是惯例：这是一种反惯例。

您仍然可以实现非 RESTful API，但您需要教您的客户如何使用它，因为没有人开发像您这样的 API。

总结：

• REST 是一种范式。你可以随它去，也可以走自己的路。
• 如果您不使用 RESTful API，则不会产生直接的技术后果，除非您的受众默认不会理解您的 API 设计。