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

通过URL传递记录ID与通过参数传递记录ID的优缺点,url,api-design,url-design,Url,Api Design,Url Design,我正在开发一个API,我想知道通过URL传递ID与作为参数访问记录是否有任何优点/缺点 示例:获取ID为1的消息的信息 您可以使用example.com/messages/1执行此操作,它将以JSON格式返回ID为1的消息 或者您可以执行example.com/messages?id=1 有什么理由选择一个而不是另一个,还是仅仅是个人喜好?您前面的示例更具可读性和直观性。开发人员在API的两个方面都可以更轻松地使用它。对于web API来说,它也是更标准的。大多数框架设计为支持两种形式的URL。

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

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

您可以使用
example.com/messages/1
执行此操作,它将以JSON格式返回ID为1的消息

或者您可以执行
example.com/messages?id=1


有什么理由选择一个而不是另一个,还是仅仅是个人喜好?

您前面的示例更具可读性和直观性。开发人员在API的两个方面都可以更轻松地使用它。对于web API来说,它也是更标准的。大多数框架设计为支持两种形式的URL。在所有其他条件相同的情况下,第一个示例可能是更好的选择。

您应该搜索REST API并阅读它们。@dlondero为什么?REST对于URL应该是什么样子根本没有什么可说的。它认为它们完全不透明。你在开玩笑吗?@dlondero Nope。REST没有提到URL。所有关于REST的最佳实践都说明了如何正确定义URL,以便在集合中包含集合和项目。