6、不要滥用JSON数组
当绝对无法避免在同一数组中返回不同类型实体时,尝试返回足够抽象的对象列表,里面包括所有对象,每个对象显示标明类型。...比如飞机和汽车不应该出现在同一个返回数组中,但是无法避免时,可以使用下面这种方式
?...7、不要依赖普通的硬编码错误信息
接口返回错误时,在响应正文中应该包括严格定义的错误对象,对象一般包括内部代码和附加信息
8、不要使用数字枚举
9、不要返回非封装的响应...如果将来需要增加其他信息,你将不得不修改根响应
10、使用JSON布尔值
11、尽量让你的接口满足HATEOAS 约束
服务器提供给客户端的表达中包含了动态的链接信息,客户端通过这些链接来发现可以触发状态转换的动作...,这样可以有效处理响应膨胀
15、接口支持高级分页
分页可以减少客户端接收的数据数目,但是当你需要将分页结果与不断接收的新条目结合时,通常的限制limit和偏移offset分页参数是低效的