请教关于 RESTFUL 风格 API 的设计

[risky]

RESTFul 风格的 API 表现为操作资源, 如果返回的资源受到业务端口的不同或者权限的不同需要返回不同的内容该如何设计呢?

目前只想到以下几种

• 针对不同的业务端口以及权限使用带有不同的描述的资源的接口, 但是会增加接口的数量并且需要定义一套资源的描述方式
• 使用相同的接口, 根据业务 /权限的不同来调整返回数据, 接口少了但是权限判断复杂, 而且接口文档难以讲明

诸位还有什么更好的思路么......

[join]

不能这么设计，权限和接口应该分开。在认证时确立好权限，然后实现接口时返回不同的数据。

[risky]

@join 没太理解 "权限和接口应该分开" 是什么意思, 目前想的认证方式是 jwt 首次登录的时候, 权限字段封装在 jwt 里请求接口的时候判断权限, 纠结的点是应该是通过一个接口不同权限返回不同数据, 还是多个接口, 不同权限调用不同的接口......

[no1xsyzy]

权限应当只决定一件事：这个接口是否允许被调用。
我怀疑你的资源粒度还不够细。

[join]

@risky 你要是这么设计会被锤的。
接口尽量简洁，朴实无华且枯燥。你见过谁的 restful 是这样设计的？设计 restful 的第一原则就是别搞创新。

[IvanLi127]

判断权限复杂的话 你分接口就不复杂了吗(;｀ O´)o 应该有优化空间吧

[Jooooooooo]

api 接口设计第一原则, 命名尽量清晰, 不查文档就知道是干嘛的

剩下的随意, 比如全是 post 接口也没事, 不靠这个

[xuanbg]

@Jooooooooo restful 原教旨主义者即将到达……