RESTful

参考

https://www.restapitutorial.com/index.html

REST or RESTful :

Representational State Transfer：表现层状态传输

REST 6个约束: six constraints:

1. uniform interface
2. stateless
3. cacheable
4. client-server
5. layered system
6. code on demand

严格遵循以上 six constraints, 才是符合 REST 风格的 api设计，其中 code on demand 是可选的。

REST API Quick Tips

1. http method verbs
   get, put, post, delete
   同一个接口，借助 http methods 区分 对应的操作：
   get: 获取资源
   put : 更新资源
   post：创建资源
   delete: 删除资源

2. sensible resources name: 便于理解的资源名（望文知义）

3. response code 规范

4. json or xml : 优先选择json作为数据格式

TESTful uri: 面向的资源，而非操作资源的动作，

design for your clients, not for your data

idempotent: 幂等

发出多个相同的请求与发出单个请求具有相同的效果，

相同的效果：
the state on the server is the same

GET, HEAD, OPTIONS and TRACE methods

are defined as safe, meaning they are only intended for retrieving data. This makes them idempotent as well since multiple, identical requests will behave the same.

GET，HEAD，OPTIONS和TRACE方法被定义为安全的，这意味着它们仅用于检索数据。这使得它们也是幂等的，因为多个相同的请求将表现相同。

对服务的7点要求： performance, scalability, simplicity, modifiability, visibility, portability, reliability

性能，可伸缩性，简单性，可修改性，可见性，可移植性和可靠性。