首页 > 技术文章 > restful restAPI 的定义方式

StephenJiang 2015-05-14 17:15 原文

今天听了一些rest 的讲解,感谢玖遥老大教导,晚上把整理出来,帮助那些和我一样有过迷茫的人!

我举的例子是经过我的老大讲解,以及观看阮一峰的restful架构的一些整合,和自己的拙劣见解。

首先:每一个URI代表一种资源(路径);

所谓"资源",就是网络上的一个实体,或者说是网络上的一个具体信息。它可以是一段文本、一张图片、一首歌曲、一种服务,总之就是一个具体的实在。你可以用一个URI(统一资源定位符)指向它,每种资源对应一个特定的URI。要获取这个资源,访问它的URI就可以,因此URI就成了每一个资源的地址或独一无二的识别符。

 

其次:域名和版本的定义;

;

如图:尽量将域名放入专属的域名下,版本号放入url中;从实用和开发便利上来讲 放URL要方便很多;

 

接着就是HTTP动词:

注解:post 和 put的区别:

1:post是新增;put是修改;

2:在有复杂,含糊不清的逻辑时使用post;

patch:比如修改某个人的某一个或者具体的某几个属性的时候使用patch;put是全部修改(小编至今还没使用过patch);下面的例子方便理解

 

filter:比如分页;返回数据太多,需要有选择的显示,这时候就需要过滤器;

 

 

状态码(Status Codes)

 

  

推荐阅读