Web API - 要放置/路由什么？

Question

所以，

我正在开发一个REST API，我只有资源映射到某些输出使用的路由，我只是不关心根路由（/），但我很好奇人们做什么。

人们在REST API上放置了哪些内容？

资源列表？所有资源？有没有什么“良好的API实践”可以告诉我关于这方面的一些情况？

???

Answer 1

在由超媒体驱动的真正RESTful API中，根URI通常是入口点，客户端将事先知道的唯一URI。它应该返回一个带有其他资源链接的文档。如果你不明白这是什么意思，请阅读this。

在街道的REST API，我们在互联网看到的 - 不使用HATEOAS，并没有真正的RESTful - 有没有真正的约定，但我已经看到很多模式：

• 一个“你好世界”。
• 重定向到主页面。
• 重定向到API文档。
• 状态页面，包含一些服务器信息。
• 实际的超媒体文档，带有一些链接。
• 用户配置文件信息