什么是 REST API？

原创于 2026-06-30 10:19:05 发布 · 52 阅读

1 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#SOVD

S-CORE 专栏收录该内容

7 篇文章

订阅专栏

什么是 REST API？

REST（Representational State Transfer，表现层状态转移）是一种广泛应用于互联网 Web 服务的软件架构风格。
而 REST API 就是基于这种风格设计的应用程序接口。它将系统中的所有事物（如诊断数据、故障码、ECU组件）都视为**“资源”（Resources）**，并为每个资源分配一个唯一的 URL（统一资源定位符）。

🔑 REST API 的核心特征

使用标准的 HTTP 方法：对资源的操作直接映射到 HTTP 的基础动词上。
无状态性 (Stateless)：每个请求都包含服务器理解并处理该请求所需的全部信息，服务器不保存客户端的上下文。
数据格式通用：通常使用 JSON（JavaScript Object Notation）格式来传输数据，这种格式可读性极强，易于解析。

🔌 SOVD 中是如何使用 REST API 进行通信的？

在传统的汽车诊断中，如果想读取一个 DID，你需要发送一串十六进制报文（例如 UDS 的 22 EE 48）。而在 SOVD 的 REST API 架构中，一切都变成了发送一个 Web 请求。

1. 资源定位 (URL)

SOVD 将车载诊断资源抽象为 URL 路径。例如：

获取所有组件列表：http://<ECU_IP>:<Port>/sovd/v1/components
读取 DID 0xEE48 的数据：http://<ECU_IP>:<Port>/sovd/v1/data/0xEE48
获取故障码 (DTC) 列表：http://<ECU_IP>:<Port>/sovd/v1/faults

2. HTTP 动词与诊断操作的映射 🔄

REST API 的核心在于用不同的“动作”对同一个 URL 进行操作：

HTTP 方法 (Method)	诊断对应操作	实际应用示例 (以 `VSPS_SOVD_DEMO` 为例)
GET	读取资源信息	`GET /sovd/v1/data/0xEE49` 👉 读取该可读写 DID 的当前值。
PUT / POST	写入/更新资源	`PUT /sovd/v1/data/0xEE49` (携带数据 `{ "value": 5 }`) 👉 写入新值 5 到该 DID。
DELETE	删除/清除资源	`DELETE /sovd/v1/faults` 👉 清除 ECU 中的所有故障码（等同于 UDS ClearDTC）。

3. 数据载体 (JSON Payload) 📦

无论是请求还是响应，数据都打包在 JSON 格式中。

例如，写入数据时的请求体 (Request Body)：

JSON
```
{ "value": "05" } 
```

读取故障码时的返回体 (Response Body)：

JSON

{ "faults": [ { "code": "0x4D2", "status": "active", "description": "DTC 0x4D2 test failed" } ] }

🛠️ Bruno 与 SOVD 服务器的通信流程

Bruno 在这里充当了一个 API 客户端（Web Client） 的角色（类似于 Postman）。

建立连接：Bruno 运行在开发电脑上，通过以太网（通常是 TCP/IP）连接到目标 ECU（例如运行在 QEMU 虚拟机中的 Linux，IP 为配置中的 192.168.x.x，端口通常是 SOVD 服务监听的端口，如 8080 或 80）。
发送请求：当你在 Bruno 中点击 "Send" 按钮（例如 Read DID 0xEE48），Bruno 会构建一个标准的 HTTP 请求：

http
```
GET /sovd/v1/data/0xEE48 HTTP/1.1 Host: 192.168.40.20:8080 Accept: application/json 
```
服务器处理：部署在目标 ECU 上的 SOVD 服务器（包含在 VSPS 运行时中）收到这个 HTTP 请求，解析 URL，调用底层的自适应 AUTOSAR 诊断模块（如 ara::com 或 ara::diag）获取 CPU 负载。
返回响应：SOVD 服务器将结果包装成 HTTP 响应并发送回 Bruno：

http
```
HTTP/1.1 200 OK Content-Type: application/json { "value": "35" } 
```
(35 代表当前的 CPU 负载值)