应该能充分表达出真实作用,而不是需要翻阅文档才能了解,另外不要不情愿使用版本号命名路由,当然服务版本应该要做到向下兼容
3、数据类型强一致
数值字段应该始终只包括数字,字符类型字体意义始终只包括字符串...什么时候会变得可用?...客户端可以缓存服务器返回的响应结果,服务器可以定义响应结果的缓存时长设置
13、为你的接口实现限流
API确实实施了速率限制的话,请务必通过响应提供其当前状态来告知你的调用者...保持客户端同步一个比较好的办法是使用before_id和after_id参数组合,比如客户端将已知的最新条目的id作为after_id请求参数,然后检索之后创建的新条目
16、接口异常显式返回...RPC调用中Exception应该也是返回值的一部分,应该设计成Checked Exception,尽量让调用方能够显式的处理
17、接口使用Specification规格模式
设计者应该避免太多