REST API
REST是浏览器与服务器通信方式的一种设计风格。
它的全称是“REpresentational State Transfer”,中文意为“表现层状态转换”
- Resource 资源
- Representational State Transfer 表现层
- State 状态
- Transfer 转换
REST的核心概念
- 互联网上所有可以访问的内容,都是资源
- 服务器保存资源,客户端请求资源
- 同一个资源,有多种表现形式
- 协议本身不带有状态,通信时客户端必须通过参数,表示请求不同的资源
- 状态通过HTTP动词表示
URL设计
URL是资源的唯一识别符
- /store/1
- /store/2
- /store/1/employee/2
查询字符串
查询字符串表示对所请求资源的约束条件。
- GET /zoos/animals?limit=10
- GET /zoos/1/animals?limit=10&offset=10
- GET /animals?zoo_id=1
HTTP 动词
操作 | SQL方法 | HTTP动词 |
---|---|---|
CREATE | INSERT | POST |
READ | SELECT | GET |
UPDATE | UPDATE | PUT/PATCH |
DELETE | DELETE | DELETE |
GET /v1/stores/1234
PUT /v1/stores/1234
POST /v1/stores
DELETE /v1/stores/1234