Django API：如何构造 URL 和处理查询？

Question

请原谅这个新手（可能是主观的 - 我不知道）的问题。

我想向我的网站添加一个 REST API。例如，我有一个显示所有帖子的 URL 是 /post/，我想为用户提供一种以 JSON 格式获取所有帖子的方法。

最好是：

• 定义新的 API URL 结构（例如，/api/rest/post/ 以 JSON 格式返回所有帖子）
• 使用现有的 URL 结构，并允许用户简单地在每个 URL 的末尾附加 /json/ 以获取 JSON 对象？ （例如/post/json/ 以 JSON 格式返回所有帖子）

如果是后者，那么就观点而言，是否有标准的实施方式？我是否应该在所有视图中简单地添加一个可选的json 参数？

感谢您的建议。

Answer 1

听取之前评论者的建议。但特别是使用新的 API URL 结构可能更好（/api/rest/post/，正如你所说）。分离完全不同类型的功能对您的项目总是有好处的。换句话说，您可以将您的 API 文档放在 /api/docs/ 中，它看起来会很自然。如果您使用相同的 URL 结构，则放置文档的位置将不那么明显。 答案当然也是主观的。

Answer 2

看看 Piston，它是一个处理 REST API 的 Django 插件。