RESTful规范理解

太过爱你忘了你带给我的痛 2022-05-06 06:30 192阅读 0赞

# RESTful规范理解 #

URL定位资源，用HTTP动词（GET,POST,DELETE,DETC）描述操作。  
识别(identify)、 表示(represent) 、交互(interact with)。

*  看url就知道要什么
 *  看http method就知道干什么
 *  看http status就知道结果如何

## 1. 使用URL定位资源 ##

RESTful风格的URL用于指定资源，URL中只能使用名词的组合来标识资源，原则上不使用"动词"  
”资源“是整个RESTful的核心。  
*示例*：

*  [http://api.helloworld.com/v1/xiaoming/friends][http_api.helloworld.com_v1_xiaoming_friends] 表示获取小明的朋友
 *  [http://api.helloworld.com/v1/xiaoming/age][http_api.helloworld.com_v1_xiaoming_age] 表示获取小明的年龄

## 2. 使用HTTP METHOD标识对资源的操作 ##

*  GET 用来获取资源
 *  POST 用来新建资源（也可以用于更新资源）
 *  PUT 用来更新资源（也经常用于批量处理，但是不是规范的RESTful风格用法）
 *  DELETE 用来删除资源

*示例*:

*  GET [http://api.helloworld.com/v1/xiaoming/friends][http_api.helloworld.com_v1_xiaoming_friends] 表示获取小明的朋友
 *  POST [http://api.helloworld.com/v1/xiaoming/friends][http_api.helloworld.com_v1_xiaoming_friends] 表示小明新增了好友
 *  PUT [http://api.helloworld.com/v1/xiaoming/age][http_api.helloworld.com_v1_xiaoming_age] 表示小明的年龄更新了，又长了一岁
 *  DELETE [http://api.helloworld.com/v1/xiaoming/friends][http_api.helloworld.com_v1_xiaoming_friends] 表示小明把朋友拉黑了，删除了好友

## 3. 使用HTTP状态码标识请求的结果 ##

用HTTP Status Code传递Server的状态信息。

*  200 OK
 *  400 Bad Request
 *  403 Forbidden
 *  404 Not Found
 *  500 Internal Server Error

[http_api.helloworld.com_v1_xiaoming_friends]: http://api.helloworld.com/v1/xiaoming/friends
[http_api.helloworld.com_v1_xiaoming_age]: http://api.helloworld.com/v1/xiaoming/age

发表评论取消回复

表情：

评论列表（有 0 条评论，192人围观）

还没有评论，来说两句吧...

相关阅读

相关 Restful API 设计规范

简介 REST（英文：Representational State Transfer，简称REST，直译过来表现层状态转换）是一种软件架构风格、设计风格，而不是标准，只是

梦里梦外;/ 2022年10月25日 04:41/ 0 赞/ 303 阅读

相关 RESTful API 规范

首先 RESTful 是一种软件架构风格或者说是一种设计风格，并不是标准，它只是提供了一组设计原则和约束条件，主要用于客户端和服务器交互类的软件。一、协议　　在 url

一时失言乱红尘/ 2022年10月03日 00:48/ 0 赞/ 261 阅读

相关 RESTful规范理解

RESTful规范理解 URL定位资源，用HTTP动词（GET,POST,DELETE,DETC）描述操作。识别(identify)、表示(represent)

太过爱你忘了你带给我的痛/ 2022年05月06日 06:30/ 0 赞/ 193 阅读

相关 RESTful api接口规范

> 域名应该尽量将API部署在专用域名之下。 [https://api.example.com][https_api.example.com] 如果确定API很简单，不

深碍√TFBOYSˉ_/ 2022年03月07日 20:08/ 0 赞/ 418 阅读

相关 RESTful API 设计规范

RESTful 是目前最流行的 API 设计规范，用于 Web 数据接口的设计。一、URL 设计 1.1 动词 + 宾语 RESTful 的核心思想就是，客户端发出

矫情吗；*/ 2022年01月26日 06:59/ 0 赞/ 329 阅读

相关 RESTful规范

什么是RESTful REST与技术无关，代表的是一种软件架构风格，REST是Representational State Transfer的简称，中文翻译为“表征

我就是我/ 2021年12月21日 17:51/ 0 赞/ 240 阅读

相关 REST接口规范总结

1 REST REST是一种软件架构风格，如果你的接口是REST接口，那么该接口可被认为是`REST风格`的。 REST接口是围绕`资源`展开的，HTTP 的`URL

逃离我推掉我的手/ 2021年09月20日 06:36/ 0 赞/ 495 阅读

相关 RESTful API 编写规范

基于一些不错的RESTful开发组件，可以快速的开发出不错的RESTful API，但如果不了解开发规范的、健壮的RESTful API的基本面，即便优秀的RESTful开发组

逃离我推掉我的手/ 2021年09月14日 01:24/ 0 赞/ 446 阅读

相关 restful api规范

简介 restful是目前最流行的API设计规范，用于web数据接口设计 REST有主要两个核心精神：一、使用resource来当作识别的资源，也就是使用一个U

浅浅的花香味﹌/ 2021年09月03日 09:12/ 0 赞/ 501 阅读

相关 RESTful API 设计规范

RESTful API 设计规范该仓库整理了目前比较流行的 `RESTful api` 设计规范，为了方便讨论规范带来的问题及争议，现把该文档托管于 `Github`，

分手后的思念是犯贱/ 2021年07月05日 01:24/ 0 赞/ 608 阅读