,同一个字段中不应该混合多种类型数据
4、始终返回所有的字段
不要删除字段属性,即使值为空
5、不要滥用JSON对象
API中的每个JSON对象应该始终在请求之间具有不可变性...比如飞机和汽车不应该出现在同一个返回数组中,但是无法避免时,可以使用下面这种方式
?...如果将来需要增加其他信息,你将不得不修改根响应
10、使用JSON布尔值
11、尽量让你的接口满足HATEOAS 约束
服务器提供给客户端的表达中包含了动态的链接信息,客户端通过这些链接来发现可以触发状态转换的动作...保持客户端同步一个比较好的办法是使用before_id和after_id参数组合,比如客户端将已知的最新条目的id作为after_id请求参数,然后检索之后创建的新条目
16、接口异常显式返回...,不为个别使用方定义接口
定义好统一的路由接口,而非为每一个使用方定义个别处理,如果需要特殊字段,要考虑特殊字段的通用性,如果有通用性,在通用接口上加上字段,其他使用方可维持空,如果没有通用性