应该能充分表达出真实作用,而不是需要翻阅文档才能了解,另外不要不情愿使用版本号命名路由,当然服务版本应该要做到向下兼容
3、数据类型强一致
数值字段应该始终只包括数字,字符类型字体意义始终只包括字符串...,同一个字段中不应该混合多种类型数据
4、始终返回所有的字段
不要删除字段属性,即使值为空
5、不要滥用JSON对象
API中的每个JSON对象应该始终在请求之间具有不可变性...比如飞机和汽车不应该出现在同一个返回数组中,但是无法避免时,可以使用下面这种方式
?...13、为你的接口实现限流
API确实实施了速率限制的话,请务必通过响应提供其当前状态来告知你的调用者
14、考虑让你的接口返回支持字段过滤
客户端请求可以指定希望服务端在响应中包括哪些字段或者排除哪些字段...,不为个别使用方定义接口
定义好统一的路由接口,而非为每一个使用方定义个别处理,如果需要特殊字段,要考虑特殊字段的通用性,如果有通用性,在通用接口上加上字段,其他使用方可维持空,如果没有通用性