HTTP的REST服务-RESTful风格API

 

1. Rest关键词解释
2. REST概念
3. REST遇到的问题及示例
4. 总结

一. Rest关键词解释

1. REST(Representational State Transfer)：表述性状态转移
2. Rest是web服务的一种架构风格,一种轻量级,跨平台,跨语言的架构设计;

二. Rest概念

在RESTful架构中，每个网址代表一种资源（resource），所有网址请求接口中不能有动词，只能有名词,这点和数据库设计风格很像。

那么可能有同学会问了？动词怎么来表示呢？

常用的HTTP动词有五个,对应sql中命令。也就是说我们定义接口url中一般不会出现动词，都是使用名词,而动词使用HTTP请求方式来表示。

• GET（SELECT）：从服务器取出资源（一项或多项）。
• POST（CREATE）：在服务器新建一个资源。
• PUT（UPDATE）：在服务器更新资源（客户端提供改变后的完整资源）。
• PATCH（UPDATE）：在服务器更新资源（客户端提供改变的属性）。
• DELETE（DELETE）：从服务器删除资源。
• 
• 

三. REST遇到的问题

复数形式怎么表示？

• https://api.example.com/v1/zoos
• https://api.example.com/v1/animals
• https://api.example.com/v1/employees

版本怎么表示(演示中我们参考github的风格)？

其实一般互联网技术类公司都有自己的风格,这个参考就好

• https://developer.github.com/v3/media/#request-specific-version (Github采用这种做法)

例子

• GET /zoos：列出所有动物园
• POST /zoos：新建一个动物园
• GET /zoos/ID：获取某个指定动物园的信息
• PUT /zoos/ID：更新某个指定动物园的信息（提供该动物园的全部信息）
• PATCH /zoos/ID：更新某个指定动物园的信息（提供该动物园的部分信息）
• DELETE /zoos/ID：删除某个动物园
• GET /zoos/ID/animals：列出某个指定动物园的所有动物
• DELETE /zoos/ID/animals/ID：删除某个指定动物园的指定动物