1

我刚刚开始学习如何设计/编写 RESTful API。我有一个普遍的问题:

假设我有某种简单的 SQL 数据库,并且我正在编写一个 API,它允许创建新记录、查看记录、删除记录或更新记录。

假设我想删除一条记录,通常是在 URL 中传入记录的 ID 更好,例如,/api/delete_record?id=10还是最好执行以下操作:

/api/record并让它接受GET、和POST,并且数据通过请求中的 JSON 正文进行处理。PATCHDELETE

我在 Python 中使用 Flask 编写了一个小型 API,而我只有一个 URL:/record它接受上述所有 HTTP 方法。它查看请求中的方法,并相应地期望 JSON 中的请求正文。这被认为是好的还是坏的做法?

任何建议将不胜感激。请注意,我对这一切还是很陌生。我以前使用过 API,但从未开发过任何 API。谢谢!

4

1 回答 1

3

删除资源的正确 RESTful 方式是发送 DELETE 请求,并将范围信息放在 URI(而不是正文)中,例如/api/records?id=10or /api/records/10。方法信息应该在 HTTP 方法中,而不是 URI。

我建议您阅读“RESTful Web 服务”以了解 API 设计的最佳实践。

于 2012-11-13T17:27:46.017 回答