优化

墨家设备测量上传接口说明-V3.md

@@ -31,10 +31,10 @@ POST <GATEWAY_HOST>/openapi/v1/inbound-measurements
 |---|---|---|
 | `Content-Type` | 是 | `application/json` |
 | `X-App-Key` | 是 | 柏悦分配的固定应用标识 |
-| `X-Timestamp` | 待确认 | Unix 毫秒时间戳 |
-| `X-Nonce` | 待确认 | 每次请求唯一的随机字符串 |
-| `X-Signature` | 待确认 | HMAC-SHA256 动态签名 |
-| `Idempotency-Key` | 待确认 | 网络重试时用于识别同一次上传 |
+| `X-Timestamp` | 否 | 首轮联调关闭签名，不传 |
+| `X-Nonce` | 否 | 首轮联调关闭签名，不传 |
+| `X-Signature` | 否 | 首轮联调关闭签名，不传 |
+| `Idempotency-Key` | 否 | 当前同箱号重复上传直接覆盖，不要求设备生成 |
 
 请求 JSON：
 
@@ -80,7 +80,7 @@ data:image/jpeg;base64,<Base64内容>
 
 ## 6. 重试约定
 
-网络超时或未收到响应时，设备可以重试同一次上传。若柏悦最终确认启用 `Idempotency-Key`，同一次重试必须使用相同的幂等键；新的测量上传使用新的幂等键。
+网络超时或未收到响应时，设备可以重试同一次上传。当前按 `boxCode` 保存最新结果，同一个箱号重试不会新增多条当前记录。
 
 同一个 `boxCode` 后续再次上传时，以最新一次设备测量结果为准，设备无需额外传版本号。
 
@@ -90,7 +90,6 @@ data:image/jpeg;base64,<Base64内容>
 2. `picture` 是否可以按 `data:image/jpeg;base64,...` 格式上传。
 3. `weight` 的单位、精度和是否必传。
 4. `machineNo` 是否每台机器固定且唯一。
-5. 设备是否支持每次请求动态生成 HMAC-SHA256 签名。
-6. 设备是否支持在网络重试时携带同一个请求幂等键。
+5. 首轮联调完成后，再共同确认动态 HMAC-SHA256 签名的启用时间。
 
-柏悦侧会另行提供正式接口地址、固定 AppKey、认证参数和测试数据。本说明不包含任何真实密钥或柏悦内部业务处理规则。
+柏悦侧会另行提供正式接口地址、固定 AppKey 和测试箱码。首轮联调只校验固定 AppKey，不需要 Secret；本文不包含任何真实密钥或柏悦内部业务处理规则。