📚 课程目录第2章 HTTP协议基础

2. HTTP 协议基础：请求方法与状态码

在边缘计算场景中，HTTP 协议是设备与平台之间最通用的数据采集与指令下发通道。本章聚焦 HTTP 的核心要素：请求方法、状态码、请求头与响应头，为后续的 API 数据采集和设备接入配置打下坚实基础。

2.1 HTTP 请求方法

HTTP 定义了多种请求方法，用于指示对资源执行的操作。在边缘计算中，最常用的四种方法是 GET、POST、PUT 和 DELETE，它们对应了典型的 CRUD（创建、读取、更新、删除）操作。

方法	语义	边缘计算典型用途	请求体	幂等性
GET	读取资源	采集传感器当前值、查询设备状态	无	是
POST	创建资源 / 提交数据	上报设备日志、触发边缘计算任务	有	否
PUT	更新 / 替换资源	更新设备配置参数、固件版本号	有	是
DELETE	删除资源	移除离线设备、清理过期规则	通常无	是

幂等性提示： 幂等方法（GET、PUT、DELETE）无论执行一次还是多次，服务器端资源状态保持一致。POST 非幂等，重复提交可能创建多条重复记录。在边缘设备上报场景中，建议使用 PUT 或 PATCH 来保证数据一致性。

2.2 HTTP 状态码

状态码由三位数字组成，用于表示服务器对请求的处理结果。边缘计算设备接入时，必须能正确解析以下常见状态码：

分类	状态码	含义	边缘计算场景说明
2xx 成功	200 OK	请求成功	GET 查询成功，返回传感器数据
2xx 成功	201 Created	资源创建成功	POST 上报新设备成功
4xx 客户端错误	400 Bad Request	请求格式错误	设备上报的 JSON 格式不合法
4xx 客户端错误	404 Not Found	资源不存在	请求的设备 ID 在平台未注册
5xx 服务器错误	500 Internal Server Error	服务器内部错误	边缘网关处理数据时发生异常
5xx 服务器错误	503 Service Unavailable	服务暂时不可用	边缘节点过载或正在重启

设备接入避坑： 边缘设备通常资源受限，建议在设备端实现 指数退避重试 策略。当收到 5xx 状态码时，不要立即重试，应等待 1s、2s、4s… 逐步增加间隔，避免对边缘网关造成二次冲击。

2.3 请求头与响应头

HTTP 头部（Headers）是请求和响应中的元数据，用于传递内容类型、认证信息、缓存策略等。在边缘计算 API 数据采集中，以下头部字段最为关键：

2.3.1 常见请求头

请求头	作用	示例值
`Content-Type`	指定请求体的媒体类型	`application/json`
`Authorization`	携带认证凭证（Token / API Key）	`Bearer eyJhbGciOiJIUzI1NiIs...`
`Accept`	告知服务器客户端期望的响应格式	`application/json`
`X-Request-ID`	自定义请求追踪 ID（边缘链路追踪）	`edge-20250321-001`

2.3.2 常见响应头

响应头	作用	示例值
`Content-Type`	指示响应体的媒体类型	`application/json; charset=utf-8`
`Retry-After`	告知客户端多久后重试（配合 503 使用）	`120`（秒）
`X-RateLimit-Remaining`	API 调用剩余配额	`99`

2.4 HTTP 请求与响应流程（SVG 图）

下图展示了一个典型的边缘设备通过 HTTP POST 方法上报温度数据，并接收服务器响应的完整流程：

2.5 实战：使用 cURL 模拟设备数据上报

以下示例演示了一个边缘温度传感器通过 HTTP POST 方法向平台上报数据，并携带必要的请求头：

# 边缘设备上报温度数据
curl -X POST https://api.edge-platform.com/v1/devices/temp-sensor-01/data \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer edge_device_token_abc123" \
  -H "X-Request-ID: edge-req-20250321-001" \
  -d '{
    "temperature": 25.6,
    "humidity": 68.2,
    "timestamp": "2025-03-21T10:30:00Z"
  }'

服务器成功接收后，将返回如下响应：

HTTP/1.1 201 Created
Content-Type: application/json; charset=utf-8
X-RateLimit-Remaining: 99

{
  "status": "success",
  "message": "数据接收成功",
  "data_id": "d-20250321-001234"
}

  关键要点：
  始终携带 Content-Type: application/json 头部，确保服务器正确解析 JSON 格式的请求体。
使用 Authorization 头部传递设备身份凭证，避免未授权访问。
通过 X-Request-ID 自定义头部实现端到端链路追踪，便于排查边缘节点到云平台的通信问题。

2.6 本章小结

本章系统梳理了 HTTP 协议在边缘计算数据采集中的核心要素：

请求方法：GET 用于查询，POST 用于上报，PUT 用于更新，DELETE 用于删除。
状态码：2xx 表示成功，4xx 表示客户端错误，5xx 表示服务器错误。
请求头与响应头：Content-Type、Authorization、X-Request-ID 是边缘设备接入的关键头部。