REST API详解

最新推荐文章于 2025-10-03 11:40:24 发布
原创 最新推荐文章于 2025-10-03 11:40:24 发布 · 1.8w 阅读 · 38 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#网络 #REST

本文深入解析REST（Representational State Transfer）架构风格，介绍了REST的基本概念、核心要求，以及基于HTTP的REST API工作原理。通过实例演示了如何使用REST API进行资源操作，并阐述了REST API的优缺点。
部署运行你感兴趣的模型镜像

原创Blog，转载请注明出处
blog.youkuaiyun.com/hello_hwc

由于接下来会把博客更新的重心放到网络上来。想来想去，直接写Demo，讲解API似乎不是一个好的方式。网络涉及到的概念太多，我就挑几个我认为需要提前理解的概念来讲解下。然后，我会更新几篇IOS中网络编程的博客，关于NSURLSession以及IOS的一个很火的开源库AFNetworking。

一 REST的概念

REST（Representational State Transfer）含状态传输是一种软件架构风格。
要点

资源由URI（统一资源定位符）的来指定。
通过资源的表现形式来操作资源
对资源的操作包括获取、创建、修改和删除资源，对应HTTP协议提供的GET、POST、PUT 和DELETE方法
这里写图片描述
- 安全－指的是对原有资源没有任何影响
- 等幂－不管操作多少次对资源的影响都是一样的。

这里，再讲解下PUT和POST的区别


  2. 最大的区别是PUT是等幂的，也就是同一个操作，不管PUT多少次，都是一样的。而POST则不一样，POST多次会导致多个资源被创建。
  3. PUT需要完整的URI，而POST不需要。如果，URL不完整，PUT不会被执行。
    这里写图片描述


简单来说，REST就是对资源的操作都可以通过URI来完成,REST是基于资源的。

二 REST的要求

客户端和服务器的架构
链接协议的无状态（协议本身不记录链接的状态信息）
层次化的系统
可以利用Cache来提高性能

三 基于HTTP的REST简介

REST API不依赖于协议，但是几乎全部的REST都是基于HTTP协议的。因此，举例也就只举HTTP的例子。基于HTTP的REST API包括三部分：

1 资源的URI
2 资源的传输格式
3 对资源的操作（GET、POST、PUT，DELETE，Options，Head方法）

HTTP的交互的过程是客户端发出一个请求，然后服务器返回一个请求。交互的过程中，处理传递的数据之外，也需要一些meta Data用来传递额外的信息（例如接受的数据格式，授权，证书等信息）。一个REST的HTTP请求如图

其中

  • VERB是HTTP的方法，例如GET POST DELETE等
  • URI指定资源的位置
  • HTTP Version，HTTP的版本
  • Request Header。header包含了metaData，也就是上面说的额外信息。
  • Request Body，实际传递的消息。

例如，一个GET 方法,（默认在浏览器中输入URL然后回车，就是GET方法）

GET www.baidu.com
Accept:*/*
Accept-Encoding:gzip, deflate, sdch
Accept-Language:zh-CN,zh;q=0.8,en;q=0.6
Connection:keep-alive
Content-Type:text/plain; charset=utf-8
Cookie:BDUSS=1hCVG9GN29OSkkwdld-MEh3enJBLUVnZGxKRTB5NTBCQW5BamRobTB4SGtzTWxVQVFBQUFBJCQAAAAAAAAAAAEAAADZ4YEvx6PE47XEX1pVT8rWAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAOQjolTkI6JUT; BAIDUID=8BD0E853CDCBAD524D6691E5AE0C61BB:FG=1; BAIDUPSID=8BD0E853CDCBAD524D6691E5AE0C61BB; locale=zh; MCITY=-289%3A; B64_BOT=1; BD_HOME=1; BD_UPN=123253; BDRCVFR[feWj1Vr5u3D]=I67x6TjHwwYf0; H_PS_645EC=a1bfJPwk9lOpMwLUJPTu1EGEjyg7U%2B0iMwXeWzgjyMiK62RLlrkuWmGwFvFTes98m0qN; BD_CK_SAM=1; BDSVRTM=84; H_PS_PSSID=12760_12528_1443_12772_12691_12717_12721_12728_12735_12739_12743_12763_12781_8498_11422
Host:www.baidu.com
User-Agent:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.76 Safari/537.36

上述除了GET www.baidu.com之外都是headers。具体的header字段含义可以参考wiki
http://en.wikipedia.org/wiki/List_of_HTTP_header_fields

发出请求后，服务器返回响应。响应的格式如下

  • HTTP Version HTTP的版本
  • Response Code 表示请求的状态。例如404Not found不少人遇到过吧
  • Response Header表示返回信息的头信息
  • Response Body 包含实际数据

例如，上述对www.baidu.com的GET方法
Response Code

Status Code:200 OK 表示请求成功

Response Header

BDPAGETYPE:2
BDQID:0xf0ed07ea0034f3f2
BDUSERID:797041113
Cache-Control:private
Connection:keep-alive
Content-Encoding:gzip
Content-Type:text/html
Date:Mon, 09 Mar 2015 01:53:10 GMT
Expires:Mon, 09 Mar 2015 01:53:10 GMT
Server:BWS/1.1
Set-Cookie:BDSVRTM=326; path=/
Set-Cookie:BD_HOME=1; path=/
Set-Cookie:H_PS_PSSID=12760_12528_1443_12772_12691_12717_12721_12728_12735_12739_12743_12763_12781_8498_11422; path=/; domain=.baidu.com
Transfer-Encoding:chunked
Via:1.1 hkidc-dmz-wsa-4-mgmt.cisco.com:80 (Cisco-WSA/8.5.0-497)

Response Body

是一个HTML网页，内容过多，这里不列出来了。

四 举例

首先介绍一个小工具，Chrome的扩展程序，用来测试REST API。
Advanced REST Client
这里写图片描述
然后，我们利用这个程序来测试一个免费的获取天气的网站REST API。
网站地址
http://openweathermap.org/current

然后，用这个工具来测试GET方法
GET http://api.openweathermap.org/data/2.5/weather?q=Shanghai,china

Status
200 OK Show explanation Loading time: 388


Request headers 
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.76 Safari/537.36
Content-Type: text/plain; charset=utf-8 
Accept: */*
Accept-Encoding: gzip, deflate, sdch
Accept-Language: zh-CN,zh;q=0.8,en;q=0.6
Cookie: __utmt=1; __utma=124807636.1438772543.1425606715.1425869175.1425872408.7; __utmb=124807636.1.10.1425872408; __utmc=124807636; __utmz=124807636.1425777557.4.2.utmcsr=so.com|utmccn=(organic)|utmcmd=organic|utmctr=weather.com%20REST%20API


Response headers 
Server: nginx 
Date: Mon, 09 Mar 2015 03:46:05 GMT 
Content-Type: application/json; charset=utf-8 
Transfer-Encoding: chunked 
Connection: keep-alive
X-Source: redis
Access-Control-Allow-Origin: *
Access-Control-Allow-Credentials: true
Access-Control-Allow-Methods: GET, POST

返回的message内容

{“coord”:{“lon”:121.47,”lat”:31.23},”sys”:{“type”:1,”id”:7452,”message”:0.1765,”country”:”China”,”sunrise”:1425852688,”sunset”:1425895071},”weather”:[{“id”:804,”main”:”Clouds”,”description”:”overcast clouds”,”icon”:”04d”}],”base”:”cmc stations”,”main”:{“temp”:283.62,”pressure”:1027,”humidity”:81,”temp_min”:282.15,”temp_max”:285.93},”wind”:{“speed”:6,”deg”:310},”clouds”:{“all”:90},”dt”:1425869026,”id”:1796231,”name”:”Shanghai”,”cod”:200}

五 REST的优点

通讯本身的无状态特性会提高服务器对请求的处理能力
浏览器的本身就是客户端
相对于其他叠加在HTTP协议之上的机制，REST的软件依赖性更小
可以利用缓存来提高性能

参考资料：
http://zh.wikipedia.org/zh-cn/REST
http://www.drdobbs.com/web-development/restful-web-services-a-tutorial/240169069?pgno=2

您可能感兴趣的与本文相关的镜像

Stable-Diffusion-3.5

Stable-Diffusion-3.5

图片生成
Stable-Diffusion

Stable Diffusion 3.5 (SD 3.5) 是由 Stability AI 推出的新一代文本到图像生成模型，相比 3.0 版本，它提升了图像质量、运行速度和硬件效率

SDN北向接口之REST API
weixin_43265596的博客
05-07 6302
1.北向接口 2.北向接口的分类 2.1 功能性北向接口 2.2 基于意图的业务模型描述 3.北向接口的实现 4. REST API 4.1 REST的几个重要概念 4.2 REST的约束条件与原则 4.3 REST API的设计规范 4.3.1 资源的原型 4.4 RESTful设计中URI命名的规范 4.4.1 资源命名规范 4.4.2 URI命名规范 4.4.3 U...
动手学Ollama： Ollama REST API 详解与实战指南
Yoouc1的博客
08-24 1061
Ollama本地大模型部署指南 摘要：本文详细介绍了Ollama轻量级本地大语言模型框架的REST API使用指南。主要内容包括：核心API端点解析（如文本生成的/api/generate接口）、多模态调用方法、性能优化技巧（上下文窗口设置、keep_alive参数）以及实际应用场景（文本生成、智能问答系统）。重点阐述了本地部署优势：数据安全、响应速度快、成本可控等特点，并提供了错误处理和调试技巧。文章还包含完整的Python调用示例，帮助开发者快速上手Ollama API开发。
ios调用restful接口_使用IOS进行身份验证的Restful API调用
weixin_39755003的博客
12-21 240
我正在使用prestashop API使用restful API调用的应用程序.我是IOS的新手我在android中编写了相同的方法：InputStream is = null;try {DefaultHttpClient client = new DefaultHttpClient();/* adding credentials as it is RESTful call */String us...
REST API
最新发布
2502_92141759的博客
10-03 947
REST（Representational State Transfer，表现层状态转移）是一种软件架构风格，用于设计网络应用程序接口（API）。REST API 是遵循 REST 原则的 API，它使用 HTTP 协议进行通信，通常以 JSON 或 XML 格式传输数据。REST 不是一种协议或标准，而是一组设计原则，使 API 更加简洁、可扩展和易于理解。REST API 是一种灵活、可扩展的接口设计风格，通过使用标准 HTTP 方法和状态码，使不同系统之间的通信变得简单。
移动App的REST API设计实践
it_man的专栏
09-28 1万+
通讯协议一些只是对服务器数据进行CRUD操作的App，通常采用HTTP协议，为了安全也可以采用HTTPS协议。IM软件可以选择使用XMPP协议。其他一些特有场景的App可能基于Socket自定义协议。SOCKET是实现传输层协议的一种编程API，可以是TCP，也可以是UDP。TCP --- 传输控制协议,提供的是面向连接、可靠的字节流服务。TCP提供超时重发，丢弃重复数据，检验数据，流量控制等功能
(Swift) iOS Apps with REST APIs(五) -- 整合REST API和表格视图
cd826_dong的博客
07-17 1430
本文将继续前面的教程，继续讲解如何通过REST API获取数据列表并解析为Swift对象，然后显示在表格视图中。 重要说明: 这是一个系列教程，非本人原创，而是翻译国外的一个教程。本人也在学习Swift，看到这个教程对开发一个实际的APP非常有帮助，所以翻译共享给大家。原教程非常长，我会陆续翻译并发布，欢迎交流与分享。 为什么使用像Alamofire这样的库关于编程中最难的两件事情有一堆的
SDN软件定义网络之REST API（SDN控制器）
Sun_Raiser的博客
07-26 1221
SDN软件定义网络之REST API（SDN控制器） 主要开源控制器 POX控制器-python POX中主要组件和功能的介绍 代码结构十分简单，无需安装即可使用 阅读forwarding文件中的简单例子，即可理解API的使用 Ryu（基于SDN的框架）-python Ryu主要组件和库函数 NetConf、OF-conf、sFlow控制功能 Topology 拓扑图构建、链路状态跟踪 OF-wire版本支持 OF REST 提供REST API VRRP 改善网络可靠性 可以作为Op
cURL操作Openstack对象存储的ReST API详解
01-20
由于最近工作需要使用Openstack ,使用cURL操作Openstack对象存储的ReST API，这是本人找了好多资料完成的，这里记录下。 使用Openstack ,使用cURL操作Openstack对象存储的ReST API  cURL 是一个利用URL语法规定来...
智能家居新利器：SmartThings REST API详解
smartthings-rest-api 是指与SmartThings平台相关的REST API（Representational State Transfer Application Programming Interface），用于实现家庭自动化解决方案。REST API是一种网络服务接口，用于使开发者能够...
Node.js实现的Waterloo Works交互REST API详解
资源摘要信息:"waterloo-works-api是一个为Node.js设计的REST API，它能够与名为Waterloo Works的应用程序交互。Waterloo Works是一个独立于滑铁卢大学的系统，而waterloo-works-api通过模拟用户登录和数据解析的...
ios调用restful接口_做iOS上最好的REST API测试App
weixin_39603613的博客
12-21 776
对于Web开发者和移动应用开发者来说，少不了和REST API打交道。何为REST API，维基百科是这么解释的(https://zh.wikipedia.org/wiki/REST)REST(英文：Representational State Transfer)是Roy Thomas Fielding博士于2000年在他的博士论文中提出来的一种万维网软件架构风格，目的是便于不同软件/程序在网络(...
REST API 详解
qq_39321234的博客
05-02 1万+
REST（Representational State Transfer，表述性状态转移）是一种用于构建分布式系统的架构风格。REST API（Application Programming Interface，应用程序接口）是一种基于REST风格的网络API，通常用于Web服务中。REST API使用常见的HTTP方法（如GET、POST、PUT、DELETE等）与Web服务交互，通过URI（Uniform Resource Identifier，统一资源标识符）定位资源。
iOS开发笔记之九十七——关于Restful API的一些总结
iOS开发笔记
02-24 1295
*****阅读完此文，大概需要3分钟******
REST API 中的 HTTP 请求参数
06-25 1264
HTTP请求参数允许你将信息从客户端（例如，Web 浏览器或移动应用）传输到服务器端的 Web 应用程序。它们通常用于提供条件查询、过滤结果或指定应返回哪些数据。
HTTP的REST服务-RESTful风格API
热门推荐
心静自然凉zc的博客
11-01 1万+
  Rest关键词解释 REST概念 REST遇到的问题及示例 总结 一. Rest关键词解释 REST(Representational State Transfer)：表述性状态转移 Rest是web服务的一种架构风格,一种轻量级,跨平台,跨语言的架构设计; 二. Rest概念 在RESTful架构中，每个网址代表一种资源（resource），所有网址请求接口中不能有动词，只能有...
【计算机网络】深入解析 HTTP 中的 Restful API : GET 方法、POST 方法和 GET 和 POST 的区别
OuO-1 的博客
03-09 1782
认识"方法"(method) 1.GET方法 2.POST方法 3.经典面试题:谈谈GET和POST的区别 4.其他方法
HTTP规范 RESTful API设计
2401_88238893的博客
05-06 4279
获取资源：创建资源：更新完整资源：部分更新资源：删除资源。
arcgis rest api详解
06-03
ArcGIS REST API是Esri公司提供的一种基于HTTP/HTTPS协议的Web API，用于访问和管理ArcGIS Server和ArcGIS Online等GIS服务和资源。ArcGIS REST API支持多种编程语言和平台，例如Java、Python、JavaScript、.NET、iOS和Android等。以下是ArcGIS REST API的一些主要特点和功能： 1. 支持多种HTTP操作：ArcGIS REST API支持多种HTTP操作，例如GET、POST、PUT和DELETE等，可以用于从GIS服务中获取或修改数据。 2. 支持多种数据格式：ArcGIS REST API支持多种数据格式，包括JSON、XML、HTML和二进制等，可以根据需要选择合适的数据格式。 3. 支持多种GIS服务和资源：ArcGIS REST API支持多种GIS服务和资源，例如地图服务、要素服务、空间分析服务、地理编码服务、地理处理服务、Web地图和Web应用程序等。 4. 支持数据查询和过滤：ArcGIS REST API支持对GIS服务中的数据进行查询和过滤，可以根据要求返回符合条件的数据。 5. 支持安全认证和授权：ArcGIS REST API支持多种安全认证和授权方式，例如基本认证、令牌认证和OAuth2.0认证等，可以保证GIS服务和资源的安全性和可靠性。 6. 支持跨域访问：ArcGIS REST API支持跨域访问，可以在不同的域名和网站之间进行数据交互和共享。 7. 支持自定义扩展：ArcGIS REST API支持自定义扩展，可以根据需要扩展和定制GIS服务和资源的功能和特性。 总之，ArcGIS REST API是Esri公司提供的一种基于HTTP/HTTPS协议的Web API，用于访问和管理ArcGIS Server和ArcGIS Online等GIS服务和资源，具有多种特点和功能，可以满足不同用户的需求和要求。
评论 1
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值