正确返回应该是
?
6、不要滥用JSON数组
当绝对无法避免在同一数组中返回不同类型实体时,尝试返回足够抽象的对象列表,里面包括所有对象,每个对象显示标明类型。...比如飞机和汽车不应该出现在同一个返回数组中,但是无法避免时,可以使用下面这种方式
?...7、不要依赖普通的硬编码错误信息
接口返回错误时,在响应正文中应该包括严格定义的错误对象,对象一般包括内部代码和附加信息
8、不要使用数字枚举
9、不要返回非封装的响应...13、为你的接口实现限流
API确实实施了速率限制的话,请务必通过响应提供其当前状态来告知你的调用者
14、考虑让你的接口返回支持字段过滤
客户端请求可以指定希望服务端在响应中包括哪些字段或者排除哪些字段...RPC调用中Exception应该也是返回值的一部分,应该设计成Checked Exception,尽量让调用方能够显式的处理
17、接口使用Specification规格模式
设计者应该避免太多