API、REST API、RESTful API 和 Web Service 之间的区别

API、REST API、RESTful API 和 Web Service 之间的区别

API

API,全称是 Application Programming Interface,翻译过来就是“应用程序编程接口”。

1.技术细节和示例代码:

API 通常由端点(URL)、方法(GET、POST 等)和数据格式(JSON、XML 等)组成。
示例:调用天气 API 获取天气数据:

import requests response = requests.get("http://api.weatherapi.com/v1/city?key=aaaaaa&q=Shanghai") data = response.json()print(data)

这里说的是网络 API(Web API),即通过网络请求和响应进行通信的 API。

2.API 的作用和应用场景

API 的作用是让不同的软件系统能够互相对话,比如你的手机 APP 可以通过 API 获取新闻信息,或者一个银行网站通过 API 处理支付。

Web Service

Web Service 就是通过网络进行的服务,允许不同的应用程序通过网络互相通信。它们使用标准的 XML 消息格式,可以在不同的平台和语言之间进行通信。

1.技术细节和示例代码:

Web Service 通常使用 SOAP 协议或 REST 架构。示例:使用 SOAP 请求天气信息

POST /weather HTTP/1.1 Host: www.example.com Content-Type: text/xml; charset=utf-8 Content-Length: nnn <?xml version="1.0"?><soap:Envelopexmlns:soap="http://www.w3.org/2001/12/soap-envelope"soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding"><soap:Bodyxmlns:m="http://www.example.org/weather"><m:GetWeather><m:City>London</m:City></m:GetWeather></soap:Body></soap:Envelope>

2.Web Service 的类型

SOAP Web Service:使用 SOAP 协议,比较复杂但功能强大。
RESTful Web Service:使用 HTTP 协议,更简单灵活。

3.Spring Boot环境中实现方式

在SOAP的实现中,Spring Web Services(Spring WS)和Java API for XML Web Services(JAX-WS)是两种主要的技术选择。Spring WS 是专为简化SOAP Web Services的开发而设计的,提供了一种创建文档驱动、基于SOAP的服务的方式,特别适合需要深度集成和复杂配置的企业级应用。相比之下,JAX-WS 是遵循WS-*标准的更为基础和轻量级的Java API,适用于需要标准Java支持且配置较少的场景。

@WebService注解来自JAX-WS(Java API for XML Web Services)标准,它是一个专门用于创建SOAP(Simple Object Access Protocol)Web服务的API。这种方法通常用于实现符合WS-标准的Web服务,并且是Java EE规范的一部分。
@Endpoint注解来自Spring Web Services(Spring WS)项目,它专门用于处理SOAP Web服务的开发。Spring WS 不依赖于企业Java的标准,而是建立在Spring框架的基础之上,提供更灵活的配置和更好的集成。

REST API

REST 代表“表现层状态转化”,是一种架构风格,而不是协议,强调资源的表示和状态的转移,REST API 就是遵循这种风格设计的 API。使用现有的 HTTP 协议,不需要额外的协议。

1.技术细节和示例代码:

REST API 使用 HTTP 协议进行通信,常用 JSON 格式传输数据。示例:GET 请求获取用户信息

import requests response = requests.get("https://userinfo.com/users/1") user = response.json()print(user)

2.REST API 的工作原理

REST API 把所有东西看作资源,每个资源都有一个唯一的 URI(比如网址)。你可以通过不同的 HTTP 动词(GET、POST、PUT、DELETE 等)来操作这些资源。

GET/users:获取所有用户 POST/users:创建新用户 GET/users/{id}:获取特定用户 PUT/users/{id}:更新特定用户 DELETE/users/{id}:删除特定用户 

RESTful API

RESTful API 是指那些遵循 REST 原则的 API。其实,REST API 和 RESTful API 可以看作是同一个东西。

1.技术细节和示例代码:

RESTful API 设计需要遵循一些最佳实践,如资源命名规范、版本控制等。示例:POST 请求创建新用户

import requests user_data ={"name":"John Chen","username":"Johnchen","email":"[email protected]"} response = requests.post("https://userinfo.com/users", json=user_data) new_user = response.json()print(new_user)

2.REST API 的设计原则

资源的表示:所有的资源都有自己的 URI。
状态转移:客户端和服务器之间通过 HTTP 动词进行状态转移。
超媒体(HATEOAS):响应中包含下一步操作的链接。

总结

概念对比

概念对比

性能和效率对比

在这里插入图片描述

安全性对比

在这里插入图片描述

Read more

多模态检索新突破!Qwen3-VL-Embedding/Reranker AI 真正“看懂“你在搜什么,从图片到视频全拿下!

多模态检索新突破!Qwen3-VL-Embedding/Reranker AI 真正“看懂“你在搜什么,从图片到视频全拿下!

Qwen3-VL-Embedding 和 Qwen3-VL-Reranker:统一多模态表征与排序 摘要 2025年6月,Qwen 团队开源了面向文本的 Qwen3-Embedding 和 Qwen3-ReRanker 模型系列,在多语言文本检索、聚类和分类等多项下游任务中取得了业界领先的性能。 2026年1月,该团队推出了 Qwen 家族的最新成员:Qwen3-VL-Embedding 和 Qwen3-VL-Reranker 模型系列。这些模型基于开源的 Qwen3-VL 模型构建,专为多模态信息检索和跨模态理解场景设计,能够将文本、图像、文档图像和视频等多种模态映射到统一的表示空间中。 Qwen3-VL-Embedding 模型采用多阶段训练范式,从大规模对比预训练逐步发展到重排序模型蒸馏,以生成语义丰富的高维向量。该模型支持 Matryoshka 表示学习(MRL),可灵活选择嵌入维度,并能处理最多 32K tokens 的输入。作为补充,Qwen3-VL-Reranker 采用交叉编码器架构和交叉注意力机制,对查询-文档对进行细粒度的相关性评估。 两个模型系列继承了

AI 自动化测试:接口测试全流程自动化的实现方法

AI 自动化测试:接口测试全流程自动化的实现方法

在 AI 技术飞速渗透各行各业的当下,我们早已告别 “谈 AI 色变” 的观望阶段,迈入 “用 AI 提效” 的实战时代 💡。无论是代码编写时的智能辅助 💻、数据处理中的自动化流程 📊,还是行业场景里的精准解决方案 ,AI 正以润物细无声的方式,重构着我们的工作逻辑与行业生态 🌱。曾几何时,我们需要花费数小时查阅文档 📚、反复调试代码 ⚙️,或是在海量数据中手动筛选关键信息 ,而如今,一个智能工具 🧰、一次模型调用 ⚡,就能将这些繁琐工作的效率提升数倍 📈。正是在这样的变革中,AI 相关技术与工具逐渐走进我们的工作场景,成为破解效率瓶颈、推动创新的关键力量 。今天,我想结合自身实战经验,带你深入探索 AI 技术如何打破传统工作壁垒 🧱,让 AI 真正从 “概念” 变为 “实用工具” ,为你的工作与行业发展注入新动能 ✨。 文章目录 * AI 自动化测试:接口测试全流程自动化的实现方法 🤖 * 为什么传统自动化测试“卡壳”

OpenClaw 配置指南 - 定制你的 AI 助手个性

OpenClaw 配置指南 - 定制你的 AI 助手个性 📅 更新时间:2026 年 3 月 🎯 适合人群:已经安装 OpenClaw,想要定制专属 AI 助手的用户 为什么需要配置? 安装完 OpenClaw 只是第一步。真正的魅力在于定制——让你的 AI 助手拥有独特的个性、记忆和工作方式。 核心配置文件 文件作用SOUL.md助手的"灵魂" - 个性、语气、价值观AGENTS.md行为指南 - 工作流程、技能使用USER.md用户信息 - 你的名字、偏好、时区IDENTITY.md助手身份 - 名字、形象、表情符号MEMORY.

脉向AI|当豆包手机遭遇“全网封杀“:GUI Agent是通向AGI的必经之路吗?

脉向AI|当豆包手机遭遇“全网封杀“:GUI Agent是通向AGI的必经之路吗?

💡 这是「脉向AI」的深度对话 ✨ 只做一件事:邀请真正在AI一线的实践者,拆解影响千万职场人未来的真实变革 这是「脉向AI」的第一期。这个栏目是脉脉与「人民公园说AI」联手打造的思想实验室。我们坚持做一件看似简单却极有价值的事:邀请真正站在AI浪潮前沿的实践者,拆解那些影响千万职场人未来的真实变革。 不贩卖焦虑,不堆砌术语,而是让大家看到: * 🌐 这些技术变革背后的商业逻辑是什么? * 💼 它将如何重塑我们的工作方式? * 🧭 普通职场人该如何在这个浪潮中找准自己的定位? 本期,我们聚焦一个近期刷屏科技圈却又被大众忽视的话题:为什么从华为到小米,从OPPO到vivo,几乎所有国产手机厂商都在系统层面屏蔽了字节跳动的豆包AI手机功能? 💬 "表面上是商业竞争,实质是各方对'AI时代用户入口'控制权的争夺。这将直接影响未来3-5年每个人的工作方式与职业选择。" —— 张和,本期嘉宾 👤 一、嘉宾张和:站在操作系统与AI融合前沿的战略操盘手 🎓 专业背景 ✅ 前头部手机厂商OS战略规划负责人 ✅ 12年操作系统与AI融合实战经验 ✅ 主导3代AI原生