什么是 RESTful API
首先说明 REST 并不是一个单词,而是 Representational State Transfer 的缩写,翻译是'表现层状态转化'。
一、RESTful API 核心理解
最简单的解释就是:用 URL 定位资源,用 HTTP 描述操作。
具体来说:
- URL 中只使用名词来指定资源,原则上不使用动词。
- 用 HTTP 协议里的动词来实现资源的添加、修改、删除等操作。即通过 HTTP 动词来实现资源的状态扭转:
GET用来获取资源POST用来新建资源(也可以用于更新资源)PUT用来更新资源DELETE用来删除资源
二、RESTful API 设计效果
- 看 URL 就知道要什么
- 看 HTTP Method 就知道干什么
- 看 HTTP Status Code 就知道结果如何
三、示例
DELETE /friends: 删除某人的好友(在 HTTP Parameter 指定好友 ID)POST /friends: 添加好友GET /friends: 获取好友列表

