RESTful

Posted 2021-01-20 wjs521

RESTful

　　是一种软件的架构风格，设计风格，为客户端的交互提供一组设计原则的约束条件。

REST的理解

　　Representational State Transfer 表征性转移，通常我们称为资源状态转移。

　　资源 ： 只要有被引用的必要的事物。

　　URI 统一资源标志符。

　　URL 统一资源定位符。

　　URI是给我们的资源进行标识的，URL是描述我们资源地址的。

　　统一资源接口：根据HTTP请求方式的不同，对资源进行不同的操作

　　资源的表述其实就是资源的展现形式，我们客户端和服务端传输的都是资源的表述。

　　总结：

　　　　REST风格的特点如下：

　　　　（1），在web中，只要有被引用的必要都叫资源。

　　　　（2），每个URI代表一个资源，独一无二的。

　　　　（3），客户端通过HTTP的方法，对服务器端资源进行操作；

　　　　（4），客户端和服务器之间，传递这种资源的某种表现；

　　　　（5），通过超链接的指引，实现‘表现层状态转移’；

restful规范

一 面向资源编程

　　每个URL代表一种资源，URL中尽量不要用动词，要用名词。

二 根据method不同，进行不同的操作

　　GET/POST//PUT/DELETE/PATCH

三 在URL中体现版本

　　https://www.bootcss.com/v1/mycss

　　https://v1.bootcss.com/mycss

四 在URL中体现是否是API

　　https://www.bootcss.com/api/mycss

　　https://api.bootcss.com/mycss

五 在URL中的过滤条件

　　https://www.bootcss.com/v1/mycss?page=3

六 尽量使用HTTPS

　　https://www.bootcss.com/v1/mycss

七 响应时设置状态码

　　1.信息，服务器收到请求，需要请求者继续执行操作

　　2.成功，操作被成功接收并处理

　　3.重定向，需要进一步的操作以完成请求

　　4.客户端错误，请求包含语法错误或无法完成请求

　　5.服务器错误，服务器在处理请求的过程中发生了错误

八 返回值

　　GET请求 返回查到所有或单条数据

　　POST请求 返回新增的数据

　　PUT请求 返回更新数据

　　PATCH请求 局部更新 返回更新整条数据

　　DELETE请求 返回值为空

九 返回错误信息

　　返回值携带错误信息

十 Hypermedia API

　　如果遇到需要跳转的情况 携带调转接口的URL

　　ret = {

　　　　code: 1000,

　　　　data: {

　　　　　　id: 1,

　　　　　　name: ‘wjs‘,

　　　　　　depart_id: http://www.luffycity.com/api/v1/depart/8/

　　　　}　　

　　}