RESTful风格接口和特性

1、RESTful的特性

资源： 可以用一个URL（统一资源定位符）指向它，每种资源对应一个特性的URL。

URI： 统一资源标志符，用来唯一的标识一个资源
URL：统一资源定位符，是一种具体的URI，即URL可以用来标识一个资源，而且还指明了如何locate这个资源。
URN：统一资源名称，是通过名字来标识资源，比如mailto:[email protected]

表现层： 把资源具体呈现出来的形式。

比如，文本可以用txt格式表现，也可以用HTML格式、XML格式、JSON格式表现，甚至可以采用二进制格式。

状态转换： 每发出一个请求，就代表了客户端和服务器的一次交互过程，是服务器端发生“状态转换”。

HTTP协议里面，四个表示操作方式的动词：GET（获取资源）、POST（新建资源）、PUT（更新资源）、DELETE（删除资源）。

2、资源的URL设计

• 通过URL来表示资源

主资源：/api/coupon/{id}
子资源：/api/coupon/{id}/pictures（图片集合）

• 单数 & 复数

/api/users/1
/api/user/1

• 相对路径 & 请求参数

// 参数放在路径中
/api/coupon/searchCouponDetail/1745486430339072 

// 拼接的方式
/api/coupon/searchCouponDetail?couponId=1745486430339072&type=product 

？后拼接参数的方式：这种方式一般作为过滤资源