url - 通过 URL 与参数传递记录 ID 的优缺点

Question

我正在研究一个 API，想知道通过 URL 传递 ID 与作为参数来访问记录是否有任何优点/缺点。

示例：获取 ID 为 1 的消息的信息

您可以这样做，example.com/messages/1以 JSON 格式返回 ID 1 的消息。

或者你可以这样做example.com/messages?id=1。

是否有任何理由选择其中一个，或者只是个人喜好？

Answer 1

您之前的示例更具可读性和直观性。开发人员可以更轻松地在 API 的两侧使用。对于 Web API，它也更加标准。大多数框架旨在支持两种形式的 URL。在所有其他条件相同的情况下，第一个示例可能是更好的选择。