api - REST API - 通用或特定资源

Question

我目前正在从事一个项目，该项目具有用于发送内容的资源。

假设 URI 看起来像这样 http://api.somename.com/thingssender仅使用 POST 动词。

随着时间的推移，这已成为一种资源，在有效载荷中有几个“可选”元素，这些元素仅适用于发送一种类型的东西。

目前，此资源处理两种不同类型的事物(ThingA 和 ThingB)，但也会因子元素中的内容而异。因此，例如，您可以向一群人发送很多东西或一件东西。

出现了需要 ThingC 的要求。鉴于此端点将来可能会采用负载中带有可选数据的 ThingD，我开始质疑这种“包罗万象”的资源。

我担心资源的复杂性会不断增加，不仅对开发人员如此，对使用 REST API 的客户也是如此。对我来说，这只会造成困惑，而不会创造最佳体验(同样对开发人员和客户而言)。

人们对创建通用端点与特定端点有何看法？

因此，用于发送 ThingC 的特定端点 (http://api.somename.com/ThingsCSender)。它对我来说是单一的责任，并且仔细考虑底层实现不应导致任何重复的功能。

(给出的示例不是项目中的真实概念或资源:p!)

干杯

Answer 1

您是正确的，每个资源都应该有自己的 URI。有关更多信息，如果有兴趣，可以在 stackoverflow 上找到一些很好的答案:

Understanding REST: Verbs, error codes, and authentication

What exactly is RESTful programming?