image.png
1、严格的数据模型层
你的响应应该是在代码中严格定义的嵌套数据业务模型,不要依赖数据库查询结果映射,或者其他操作
2、无歧义的服务名
记住你的URL...JSON对象应该始终在请求之间具有不可变性,具有严格的定义的字段集,下面这种返回就是可怕的做法
?...如果将来需要增加其他信息,你将不得不修改根响应
10、使用JSON布尔值
11、尽量让你的接口满足HATEOAS 约束
服务器提供给客户端的表达中包含了动态的链接信息,客户端通过这些链接来发现可以触发状态转换的动作...,资源的URI和其他信息都是动态发现的,当服务端发送变化时,客户端并不需要做出修改
12、考虑让你的接口结果可缓存
客户端可以缓存服务器返回的响应结果,服务器可以定义响应结果的缓存时长设置...,这样可以有效处理响应膨胀
15、接口支持高级分页
分页可以减少客户端接收的数据数目,但是当你需要将分页结果与不断接收的新条目结合时,通常的限制limit和偏移offset分页参数是低效的