api - 休息 API : identification of resource and content varying based on authentication

Question

我正在设计一个遵循 HATEOAS/RESt 原则的 API。但是我不确定这个基本点:资源的识别。

假设这个 url:/images它公开了用户(向该用户)上传的所有图像。

假设我使用 oauth 访问 token 进行身份验证，/images 的内容将根据授权 header 而有所不同。

这是否打破了资源概念的识别？

Answer 1

没有。资源不必是静态的就可以保持 Restful 。想象一个提供时间的网络服务:

 Http://www.myservice.com/current-time/

其余剧本中的任何内容都不会要求这不能按预期工作。 照片的情况是您的服务正在返回一个基于请求中设置的信息表示的资源——通过 auth header 过滤掉所有非用户拥有的照片。你仍然返回同样的一般东西，一组照片。

与使用响应类型 header 表示您想要返回 json 表示与返回 xml 表示没有太大区别。

当您完全切换结果时，事情就会变得可疑，例如一个人获得了一组图像，而另一个人则在同一资源位置提供了上周 Glee 的成绩单。