Web 应用程序和 API 之间的区别在哪里？

Question

这个问题与this over question 高度相关。我在问另一个问题，我仍然对这个话题有点困惑。

我遇到的问题

我目前有一个 Django Web 应用程序，用户可以在该应用程序中列出他们的爱好，并且可以在他们每次完成一项爱好时增加一个计数器。我的问题是，我想将此功能扩展到前端体验之外。换句话说，我希望用户能够使用POST 请求来增加他们的爱好，比如说，来自终端或来自他们自己的脚本或其他东西。

我感到困惑的地方

我是否必须为我的网络应用创建 API 才能添加此功能？

另一种说法是，我是否必须以不同于处理来自其他地方的请求的方式处理来自前端的请求？前端请求是否会转到 URL www.hostname.com/hobbies/1 而其他请求会转到 URL www.hostname.com/api/hobbies/1？

如果我确实将POST 请求路由到与来自前端的请求相同的URL（即www.hostname.com/hobbies/1），那么google 怎么会有external APIs for Google Maps？似乎如果其他网络应用程序正在调用 Google 地图功能，那么 Google 已将这些实例与其前端分离。

Answer 1

我的问题是，我想将此功能扩展到 前端体验。换句话说，我希望用户能够 使用来自终端的 POST 请求增加他们的爱好 或来自他们自己的脚本或其他东西。

我是否必须为我的 web 应用创建 API 才能添加此功能？

很可能是的。这有几个原因：

1) 由于 Django 的 CSRF protection，来自终端/脚本的 POST 请求很可能会在您的 /hobbies/1/ 端点上失败。对于应用程序外部的请求，您需要不同类型的 authentication 和 authorization。

2) 来自终端/脚本的POST 请求最有可能将其内容编码为JSON，而通过html 表单提交的POST 请求将其内容编码为x-www-form-urlencoded。这需要完全不同类型的验证和错误处理作为响应，这导致我们进入 3)。

3) 针对您的 /hobbies/1/ 端点的 POST 请求很可能会返回 HTML 响应，这不是您的终端/脚本想要接收的，它们很可能想要接收更结构化的数据类型，例如 JSON。

结合 1) + 2) + 3) 的解决方案将为您提供/api/hobbies/1/。