目前,比较常用的标准的RESTFul API有豆瓣API以及GitHub开发者API,我们想开发一套比较标准的RESTFul API时,这两个API是比较好的参考的对象,在开发过程中,我们要合理使用RESTFul API,切勿盲目照搬标准REST,上面提到的豆瓣API和GitHub开发者API是开放API,通常我们的API并不对所有人开放,通常针对于我们的前端,也就是常说...
我的一个经验性的总结:对于开放的API,豆瓣、新浪微博、GitHub,好用,非常合适;对于内部开发,不好用。 基于资源型的RESTFul API 接口粒度和返回结果过于的“粗”,它通常返回的都是完整的数据模型,这对于客户端非常不友好。但开放API之所以开放,就是因为它不知道你到底需要什么返回结果,既然不知道,那么我干脆都返回给...
http://api.chesxs.com/v1 3.URL中只使用名词指定资源,不用动词,且推荐使用复数 服务(Server)提供的RESTful API中,URL中只使用名词来指定资源,原则上不使用动词。“资源”是REST架构或者说整个网络处理的核心。比如: http://api.chesxs.com/v1/cars // 获取某个账户下的车辆列表 http://api.chesxs.com/...
https://api.example.com/v1/ 路径(Endpoint) 路径又称"终点"(endpoint),表示API的具体网址。 在RESTful架构中,每个网址代表一种资源(resource),所以网址中不能有动词,只能有名词,而且所用的名词往往与数据库的表格名对应。一般来说,数据库中的表都是同种记录的"集合"(collection),所以API中的名词也应该使用复...
RESTfulWeb API(也称为RESTful Web服务)是一个使用HTTP并遵循REST原则的Web服务。它从以下请求资源的三个方面进行定义: URI,比如:http://example.com/resources/。 Web服务接受与返回的互联网媒体类型,比如:JSON,XML ,YAML 等。 Web服务在该资源上所支持的一系列请求方法(比如:POST,GET,PUT或DELETE)。
API必须有版本的概念,v1,v2,v3 使用Token令牌来做用户身份的校验与权限分级,而不是Cookie。 url中大小写不敏感,不要出现大写字母 使用- 而不是使用 _ 做URL路径中字符串连接。 有一份漂亮的文档~(很重要) 以上只是列出了RESTFul的部分实践原则,并非全部。 给出一个典型的RESTFul API设计风格: ...
2、REST API 与RESTful API 在第一小节中,了解了什么是REST API,接下来聊聊REST API与RESTful API之间的异同。很多初学者很容易将这两者等同起来,认为RESTful API就是REST API,这可能是单纯的从字面上去理解了,当你深入的去了解两者的本质后,你会发现其实不然。REST API是Web API设计的一种规范或者指导原则,而...
2、REST API 与RESTful API 在第一小节中,了解了什么是REST API,接下来聊聊REST API与RESTful API之间的异同。很多初学者很容易将这两者等同起来,认为RESTful API就是REST API,这可能是单纯的从字面上去理解了,当你深入的去了解两者的本质后,你会发现其实不然。REST API是Web API设计的一种规范或者指导原...
REST、RESTful、REST API API: 是应用程序编程接口,是预先定义好的函数,可以供应用程序或开发人员访问调用 REST(Representational State Transfer,表述化状态转移):指的是一组架构约束条件和原则。 RESTful:满足REST约束条件和原则的设计规范或者架构风格 REST API:是北向接口的主流设计方式,遵循RESTful设计的API ...
什么是RESTful: REST-ful,其中ful代表形容词,如helpful,powerful。这类形容词意为"full of,having the quality of"。多加在名词之后表示“充满...的、易于...、可...的、富有...的、具有...的”的意思,是最常用的形容词后缀,反义词后缀是-less。