RESTFul API 设计 简明指导与规范

---

简介

Representational State Transfer 简称 REST 描述了一个架构样式的网络系统。REST 指的是一组架构约束条件和原则。满足这些约束条件和原则的应用程序或设计就是 RESTful。

REST API是前后端分离最佳实践，是开发的一套标准或者说是一套规范，不是框架。

好处：

1. 轻量，直接通过http，不需要额外的协议，通常有post/get/put/deletec操作。
2. 面向资源，一目了然，具有自解释性
3. 数据描述简单，一般通过json或者xml做数据通讯

概念

• 资源（Resources）

REST是”表现层状态转化”，其实它省略了主语。”表现层”其实指的是”资源”的”表现层”。那么什么是资源呢？就是我们平常上网访问的一张图片、一个文档、一个视频等。这些资源我们通过URI来定位，也就是一个URI表示一个资源。

• 表现层（Representation）

资源是做一个具体的实体信息，他可以有多种的展现方式。而把实体展现出来就是表现层，例如一个txt文本信息，他可以输出成html、json、xml等格式，一个图片他可以jpg、png等方式展现，这个就是表现层的意思。
URI确定一个资源，但是如何确定它的具体表现形式呢？应该在HTTP请求的头信息中用Accept和Content-Type字段指定，这两个字段才是对”表现层”的描