不列出项目的REST URL

Question

即使没有可能使用GET /users列出用户，也可以在REST API中使用像GET /users/:user_id这样的URL吗？

如果“是”，那么GET /users应该返回404还是一个空列表？

Answer 1

由于REST没有明确定义的标准，因此您可以做任何您想做的事情，只需对其进行相应记录并在整个项目中遵循相同的标准即可。

可能是403，因为有用户，所以是更好的选择，但是禁止您列出他们

Answer 2

REST具有定义明确的约束。 您可以在Fielding论文中阅读有关它们的信息。

关于如何设计URI结构没有任何限制，因为必须将客户端与之完全分离。 因此，这不是REST问题。

简而言之，您可以使用漂亮的URI并使用自定义约定来构建它们。 您只需要注意几件事：

• 单个URI只能标识单个资源（但是单个资源可以具有多个不同的URI）-统一的接口约束/标识资源
• URI路径是分层的，查询是非分层的-URI标准（可以主观什么是分层的，什么不是主观的）
• 查询是URI的一部分（但是您可以拥有自己的路由约定，例如，路径可以标识资源，查询可以描述表示形式的详细信息）
• URI被映射到资源而不是操作（例如通过SOAP），因此，如果人类可读的URI包含动词，则URI映射可能存在缺陷

如果“是”，那么GET / users应该返回404还是一个空列表？

如果您不想向某人显示用户列表，则不要在指向用户列表的响应中放置链接。 如果他们手动调用URI，则可以发送未找到的404或禁止的403，可能是未经授权的401。 顺便说一句。 如果您是我，我将显示仅包含当前用户的用户列表。