不要依赖数据库查询结果映射,或者其他操作
2、无歧义的服务名
记住你的URL应该能充分表达出真实作用,而不是需要翻阅文档才能了解,另外不要不情愿使用版本号命名路由,当然服务版本应该要做到向下兼容
3、数据类型强一致...数值字段应该始终只包括数字,字符类型字体意义始终只包括字符串,同一个字段中不应该混合多种类型数据
4、始终返回所有的字段
不要删除字段属性,即使值为空
5、不要滥用JSON...6、不要滥用JSON数组
当绝对无法避免在同一数组中返回不同类型实体时,尝试返回足够抽象的对象列表,里面包括所有对象,每个对象显示标明类型。...,比如我们可以使用is_available布尔值标识book的状态,但是它没有表明为啥是不可用状态?...如果将来需要增加其他信息,你将不得不修改根响应
10、使用JSON布尔值
11、尽量让你的接口满足HATEOAS 约束
服务器提供给客户端的表达中包含了动态的链接信息,客户端通过这些链接来发现可以触发状态转换的动作