2、HTTP协议基础：HTTP请求方法（GET/POST/PUT/DELETE）、状态码详解、请求头与响应头

在工业物联网场景中，设备与网关、平台之间的数据交互绝大多数基于HTTP协议。理解HTTP的核心要素——请求方法、状态码、请求头与响应头——是正确配置API调用和排查通信故障的前提。本节将围绕这三个核心维度展开，并结合工业设备接入的典型场景进行说明。

2.1 HTTP请求方法：CRUD操作的网络映射

HTTP协议定义了多种请求方法，用于指示对资源执行的操作类型。在工业API中，最常用的四种方法对应着数据的增、删、改、查（CRUD）。

2.1.1 请求方法选择原则

• 安全方法（Safe Methods）： GET 和 HEAD 不会改变服务器状态，只做读取操作。工业网关的轮询读取应始终使用GET。
• 幂等方法（Idempotent Methods）： GET、PUT、DELETE 多次执行的结果与单次执行一致。在网络不稳定的工业环境中，幂等性可防止重复操作导致的数据异常。
• 非幂等方法： POST 每次执行可能创建新资源或触发新状态。设备上报数据时使用POST，即使重复发送，服务端也应通过时间戳或唯一ID去重。

2.2 HTTP状态码详解：通信结果的数字语言

每次HTTP响应都会包含一个三位数字的状态码，用于表示请求的处理结果。工业网关和设备的日志中，状态码是定位故障的第一线索。

2.2.1 状态码分类速查

2.2.2 工业场景高频状态码深度解读

• 200 OK： 请求成功。GET查询设备数据时返回此码，响应体包含设备状态。
• 201 Created： 资源创建成功。设备通过POST上报数据后，服务端返回此码表示数据已接收并存储。
• 204 No Content： 请求成功但无返回内容。常用于DELETE操作或某些配置更新指令。
• 400 Bad Request： 请求格式错误。常见原因：JSON语法错误、缺少必填字段、字段类型不匹配。
• 401 Unauthorized： 身份认证失败。设备未携带有效的API Key或Token。
• 403 Forbidden： 权限不足。设备已认证但无权访问该资源（如普通传感器尝试删除网关配置）。
• 404 Not Found： 资源不存在。请求的API路径错误，或设备ID在平台中未注册。
• 429 Too Many Requests： 请求频率超限。设备发送数据过于频繁，触发了平台的限流策略。
• 502 Bad Gateway： 网关或代理层错误。工业网关转发请求到云平台时，上游服务不可用或响应异常。
• 503 Service Unavailable： 服务暂时不可用。平台正在维护或过载，设备应等待一段时间后重试。

2.3 请求头与响应头：通信的元数据

HTTP头部（Headers）是请求和响应中的键值对，用于传递关于消息本身的元数据。在工业设备接入中，正确设置和解析头部信息至关重要。

2.3.1 核心请求头（Request Headers）

2.3.2 核心响应头（Response Headers）

2.3.3 工业设备HTTP请求示例（含头部）

以下是一个工业温度传感器通过网关向云平台上报数据的完整HTTP POST请求示例：

POST /api/v1/devices/temp-sensor-01/telemetry HTTP/1.1
Host: iot-platform.example.com
Content-Type: application/json
Authorization: Bearer dGhpcyBpcyBhIHRva2VuIGV4YW1wbGU=
X-Device-ID: temp-sensor-01
User-Agent: IndustrialGateway/2.1.0
Content-Length: 67

{
  "temperature": 25.6,
  "humidity": 68.2,
  "timestamp": "2024-07-15T08:30:00Z"
}

对应的成功响应示例：

HTTP/1.1 201 Created
Content-Type: application/json; charset=utf-8
Date: Mon, 15 Jul 2024 08:30:01 GMT
X-RateLimit-Remaining: 499
Content-Length: 52

{
  "status": "accepted",
  "message": "data received"
}

2.4 本节知识结构总览