API 接口(interface)设计 - 切换或 2 个不同的接口(interface)

Question

我正在学习界面设计。

这就是我好奇的地方。

一些开放 API 支持 2 个不同的接口(interface)来实现切换。即Instagram like界面。类似界面(like, cancel like)

将这两者分开有什么好处。(在我看来，分成两个界面会使最终用户更加复杂)

我对此提出质疑，因为它可以通过切换来实现。

即用户发送 item_id 和 user_id。服务器检查数据库(该项目是否已被喜欢)，并更新。

感谢您的回答!

Answer 1

拥有两个切换界面的真正好处是它不需要用户知道他们试图改变的事物的当前状态(即它不需要我首先查询状态)。

如果我是 API 的使用者，通常我会想要执行诸如 like 之类的操作。 -ing 某事。我很少能想到我想要执行 do the opposite of what I did previously 的操作的情况。 (除非我感觉像人字拖)。如果 like 没有两个端点和 unlike那么您首先必须轮询 API 以获取当前状态，然后在需要时执行您正在谈论的切换。

这种情况会在您的代码中引入更多逻辑，要求您对 API 进行 1-2 次调用，并假定状态在调用之间没有改变；而拥有两个端点会减少逻辑，将您的 API 调用限制为每个操作 1 个，并且您不必担心状态会意外更改。

如果您尝试 like用户已经拥有的东西like d，那么 API 将简单地返回一个成功的结果而不改变底层数据。