API规范
-小末
这个作者很懒,什么都没留下…
展开
-
API设计规范
1 端点规范 API端点就是API的URI,例如:https://api.example.com/users/me 优秀的端点设计的重要原则: 容易记忆,URI包含的功能一目了然。 1.1端点的基本设计规范 短小便于输入 人可以读懂 没有大小写混用 方便修改 不会暴露服务架构 规则统一 1.2 HTTP方法和端点 端点和HTTP可以被认定是操作对象和操作方法的关系。 URI...原创 2019-02-27 11:16:37 · 4227 阅读 · 0 评论 -
rest的API查询结果为null,返回404还是200?
今天和同事争论一个比较有意思的问题: restful风格的API查询结果为null,返回404还是200? 最后,也没出来一个结果,反正我之前返回的都是404HTTP状态码。最终反正肯定要统一的,慢慢在讨论吧。 我给出为什么要使用404状态码我的理解: 先看百度 -- > 404状态码:所请求的页面不存在或已被删除! 根据百度,我们可以思考一个问题,页面是什么? 页面肯定是...原创 2019-07-11 17:06:31 · 2766 阅读 · 4 评论