认识RESTful API

restful api

rest 全拼是resource representational state transfer，资源表现层状态转移，在网络中的进行交互的数据都是一个个资源，rest便是对这其中数据状态转移过程的规范，是一种web应用接口的规范。

rest规范

• 每一个URI都是一个资源，因为我们在请求一个接口的时候，其实就是访问服务器对应URI地址下的资源，所以说每一个URI都是一个资源。
• 同一种资源有多种表现形式(json/xml)
• 所有操作都是无状态的。（无状态就是服务器不会记录客户端访问的记录，所有记录均在客户端记录，每次相同链接都是全新的请求，各请求间相互独立；相对，有状态就是服务器会记录请求的session信息，然后相同或者关联请求会根据相应的session上下文信息进行回应，比如继续上次的访问记录进行访问）
• 可缓存，缓存对于减少服务端负载，提高服务端性能，提升客户端体验，响应数据要允许客户端缓存，并且明确标明是可缓存的。
• restful架构中各组件要统一接口，提高各组件间通信质量。

rest命名规范

• restful api的URI设计中不能使用动词要使用名词,因为每个URI好比服务的路径，对应一种资源，这是一个静态的概念。
• 对于集合资源使用复数名词，文本资源使用单数名词，

http://api.example.com/school/classes # 获取所有班级信息
http://api.example.com/school/classes/three # 获取三班信息

• /表示层级，类似于目录层级，URI结尾不要加/，因为容易造成混淆？？？
• 用-来代替_来增加URI的可读性，因为很多时候链接下方会默认有整体的下划线，会覆盖小的下划线，从而降低了可读性。
• URI中使用小写字母
• URI中不要使用扩展名，可以通过在header中指定content_type来接收响应类型的数据。