REST是一种统一URL命名和使用的规范,理念是把要操作的对象当作资源。
URL以资源命名,不使用要操作的动词,操作和状态码统一使用HTTP的method和status code。
大家都按照这个规范来,效率就高了,一看这个请求就知道是干嘛用的。
- 不在URL中出现动词。
例子,左边是不符合REST规范的,右边是符合的:
GET /rest/api/getDogs --> GET /rest/api/dogs 获取所有小狗狗
GET /rest/api/addDogs --> POST /rest/api/dogs 添加一个小狗狗
GET /rest/api/editDogs/:dog_id --> PUT /rest/api/dogs/:dog_id 修改一个小狗狗
GET /rest/api/deleteDogs/:dog_id --> DELETE /rest/api/dogs/:dog_id 删除一个小狗狗
-
使用HTTP的method表示要对资源做的操作。
-
使用HTTP的状态码表示服务端处理结果。