RESTful API概述

什么是REST

REST与技术无关，代表的是一种软件架构风格，REST是Representational State Transfer的简称，中文翻译为“表征状态转移”。这里说的表征性，就是指资源，通常我们称为资源状态转移。

什么是资源？

网络上所有的文本、图片、视频等实体，都是资源。除了实体，还可以是抽象概念，比如某人的手机号、住址等。找到某个资源，需要URL，统一资源定位符。

URL和URI

URI是统一资源标志符。URL用来描述地址，URI用来对资源进行标识。URL是URI的一个子集，通过定位的方式实现URI

RESTful规范

面向资源

每个URL代表一种资源，URL中尽量不要用动词，要用名词

根据请求方式不同，进行不同的操作

GET：     从服务器取出资源
POST：   在服务器新建一个资源
PUT：     在服务器更新资源（客户端提供改变后的完整资源）
PATCH： 在服务器更新资源（客户端提供改变的属性）
DELETE：从服务器删除资源

在URL中体现版本

https://www.cnblogs.com/v1/myclass

在URL中体现是否是API

https://www.cnblogs.com/api/vi/myclass

尽量使用HTTPS

https://www.cnblogs.com/api/vi/myclass

响应返回规范

{code: 1000, // 响应码msg: "ok",  // 描述信息data:{  // 数据id:1,name:'小强',depart_id:http://www.luffycity.com/api/v1/depart/8}
}

举例：

例如动物园中有很多的动物，如何进行增删改查？

查找一个老虎：https://www.zoo.com/api/v1/animal?class=tiger&id=1　GET
查找所有老虎：https://www.zoo.com/api/v1/animal?class=tiger　　 GET
增加一个老虎：https://www.zoo.com/api/vi/animal　　　 POST
删除一个老虎：https://www.zoo.com/api/vi/animal　　 DELETE
修改一个老虎的某个属性：https://www.zoo.com/api/vi/animal PATCH
修改一个老虎的所有属性：https://www.zoo.com/api/vi/animal PUT

我们可以看到URL中全部都是名词，对资源的操作（动作）体现在请求方式上，体现了面向资源的思想。

转载于:https://www.cnblogs.com/V587Chinese/p/11562050.html

RESTful API概述相关推荐

【内有代码】为什么不推荐使用 RESTful API?
如果你要问 Spring Boot 做什么最厉害,我想答案就在本章标题 RESTful API 简称 REST API . 本项目源码下载(https://github.com/fishpro/spr ...
python flask高级编程之restful_('Python Flask高级编程之RESTFul API前后端分离精讲',),全套视频教程学习资料通过百度云网盘下载...
资源详情 r n t某课网好评度100%的Python Flask高级编程之RESTFul API前后端分离精讲 r n t t t第1章随便聊聊 r n t t t聊聊Flask与Django,聊 ...
asp编程工具_使用ASP.NET Core构建RESTful API的技术指南
译者荐语:利用周末的时间,本人拜读了长沙.NET技术社区翻译的技术文章<微软RESTFul API指南>,打算按照步骤写一个完整的教程,后来无意中看到了这篇文章,与我要写的主题有不少相似之 ...
OData API 和 Restful API 这两个概念的区别和联系
我们在 SAP API Business Hub 里能看到 OData,SOAP 和 Restful 三种"不同"类型的 API: 它们之间到底有什么区别和联系? OData vs ...
RESTful API 编写规范
基于一些不错的RESTful开发组件,可以快速的开发出不错的RESTful API,但如果不了解开发规范的.健壮的RESTful API的基本面,即便优秀的RESTful开发组件摆在面前,也无法很好的 ...
玩转 SpringBoot 2 快速整合 | RESTful Api 篇
概述 RESTful 是一种架构风格,任何符合 RESTful 风格的架构,我们都可以称之为 RESTful 架构.我们常说的 RESTful Api 是符合 RESTful 原则和约束的 HTTP ...
RESTful API 笔记整理
每个人的理解不一,这里主要是为了自己方便整理了一下网上的资源并加上了自己的理解,有一些知识点没有扩展,主要是自己还没理解,有空会慢慢补充,或者可以从下面的链接看一下其他人的解释. 欢迎交流!!!! 0 ...
使用ASP.NET Core构建RESTful API的技术指南
译者荐语:利用周末的时间,本人拜读了长沙.NET技术社区翻译的技术文章<微软RESTFul API指南>,打算按照步骤写一个完整的教程,后来无意中看到了这篇文章,与我要写的主题有不少相似之 ...
视频教程-Ruby on Rails打造企业级RESTful API项目实战我的云音乐-Ruby/Rails
Ruby on Rails打造企业级RESTful API项目实战我的云音乐任苹蜻,爱学啊创始人 & CEO,曾就职于某二车手公司担任Android工程师后离职创办爱学啊,我们的宗旨是:人生 ...