From ab7188954afd84cfe21a6a551a3c9c9889435985 Mon Sep 17 00:00:00 2001 From: ouyangxq <775153912@qq.com> Date: Sat, 8 Aug 2026 11:05:43 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BC=98=E5=8C=96?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 墨家设备测量上传接口说明-V3.md | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/墨家设备测量上传接口说明-V3.md b/墨家设备测量上传接口说明-V3.md index 048f94f..73905b1 100644 --- a/墨家设备测量上传接口说明-V3.md +++ b/墨家设备测量上传接口说明-V3.md @@ -31,10 +31,10 @@ POST /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, ## 6. 重试约定 -网络超时或未收到响应时，设备可以重试同一次上传。若柏悦最终确认启用 `Idempotency-Key`，同一次重试必须使用相同的幂等键；新的测量上传使用新的幂等键。 +网络超时或未收到响应时，设备可以重试同一次上传。当前按 `boxCode` 保存最新结果，同一个箱号重试不会新增多条当前记录。 同一个 `boxCode` 后续再次上传时，以最新一次设备测量结果为准，设备无需额外传版本号。 @@ -90,7 +90,6 @@ data:image/jpeg;base64, 2. `picture` 是否可以按 `data:image/jpeg;base64,...` 格式上传。 3. `weight` 的单位、精度和是否必传。 4. `machineNo` 是否每台机器固定且唯一。 -5. 设备是否支持每次请求动态生成 HMAC-SHA256 签名。 -6. 设备是否支持在网络重试时携带同一个请求幂等键。 +5. 首轮联调完成后，再共同确认动态 HMAC-SHA256 签名的启用时间。 -柏悦侧会另行提供正式接口地址、固定 AppKey、认证参数和测试数据。本说明不包含任何真实密钥或柏悦内部业务处理规则。 +柏悦侧会另行提供正式接口地址、固定 AppKey 和测试箱码。首轮联调只校验固定 AppKey，不需要 Secret；本文不包含任何真实密钥或柏悦内部业务处理规则。