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 · 4170 阅读 · 0 评论 -
rest的API查询结果为null,返回404还是200?
今天和同事争论一个比较有意思的问题:restful风格的API查询结果为null,返回404还是200?最后,也没出来一个结果,反正我之前返回的都是404HTTP状态码。最终反正肯定要统一的,慢慢在讨论吧。我给出为什么要使用404状态码我的理解:先看百度 -- > 404状态码:所请求的页面不存在或已被删除!根据百度,我们可以思考一个问题,页面是什么?页面肯定是...原创 2019-07-11 17:06:31 · 2671 阅读 · 4 评论