什么是 RESTful API

什么是 RESTful API

首先说明 REST 并不是一个单词，而是 Representational State Transfer 的缩写，翻译是'表现层状态转化'。

一、RESTful API 核心理解

最简单的解释就是：用 URL 定位资源，用 HTTP 描述操作。

具体来说：

1. URL 中只使用名词来指定资源，原则上不使用动词。
2. 用 HTTP 协议里的动词来实现资源的添加、修改、删除等操作。即通过 HTTP 动词来实现资源的状态扭转：
   • GET 用来获取资源
   • POST 用来新建资源（也可以用于更新资源）
   • PUT 用来更新资源
   • DELETE 用来删除资源

二、RESTful API 设计效果

• 看 URL 就知道要什么
• 看 HTTP Method 就知道干什么
• 看 HTTP Status Code 就知道结果如何

三、示例

• DELETE /friends: 删除某人的好友（在 HTTP Parameter 指定好友 ID）
• POST /friends: 添加好友
• GET /friends: 获取好友列表