image.png
1、严格的数据模型层
你的响应应该是在代码中严格定义的嵌套数据业务模型,不要依赖数据库查询结果映射,或者其他操作
2、无歧义的服务名
记住你的URL...JSON对象应该始终在请求之间具有不可变性,具有严格的定义的字段集,下面这种返回就是可怕的做法
?...,资源的URI和其他信息都是动态发现的,当服务端发送变化时,客户端并不需要做出修改
12、考虑让你的接口结果可缓存
客户端可以缓存服务器返回的响应结果,服务器可以定义响应结果的缓存时长设置...,这样可以有效处理响应膨胀
15、接口支持高级分页
分页可以减少客户端接收的数据数目,但是当你需要将分页结果与不断接收的新条目结合时,通常的限制limit和偏移offset分页参数是低效的...RPC调用中Exception应该也是返回值的一部分,应该设计成Checked Exception,尽量让调用方能够显式的处理
17、接口使用Specification规格模式
设计者应该避免太多