本文适用于通过乔巴科技、墨家科技、几何智造电子秤上报称重数据的机构。接入鉴权后，设备继续使用原接口地址，条码、重量、尺寸、单位和业务响应格式保持原样。
¶ 1. 生成授权 key
- 在易抵达右上角菜单打开 系统参数 → 其他 → DWS接口授权。
- 点击 生成授权key，填写备注和本机构的真实员工登录账号，复制完整 key，再点击 保存。虚拟「系统」账号不能绑定。
- 同一机构可以生成多条 key，分别绑定员工；同一个 key 可用于下表中的各个接口。删除对应记录并保存，即可撤销该 key。
¶ 2. 设备在原请求中带上 key
| 设备厂商 | 原 GET 接口 | 重量 | 尺寸 |
|---|---|---|---|
| 乔巴科技 | /dws/ticket |
kg | mm |
| 墨家科技 | /dws/mohist |
g | cm |
| 几何智造 | /dws/jhzz、/dws/jhzz/{appid2} |
kg | cm |
以下两种传法任选一种：
- URL 参数：原 URL 已有参数时追加
&dwsKey=<授权key>；没有参数时追加?dwsKey=<授权key>。实际参数值应做 URL 编码。 - 请求头：设备支持自定义请求头时，可发送
X-DWS-Key: <授权key>，避免把 key 放进 URL。不要放进Authorization。
例如，乔巴科技设备在原 GET 请求中追加 dwsKey：/dws/ticket?sendcode=<原条码>&weight=<原重量>&dwsKey=<授权key>。实际调用仍使用原域名、应用前缀和完整业务参数。
开启鉴权后，接口以 key 绑定的员工身份检查业务权限。原员工账号参数可省略；如果继续传 machine、workConsole、appid 或路径里的 appid2，接口实际使用的账号必须与绑定员工一致。若不传路径账号，请使用 /dws/jhzz。
本次也校验上述地址对应的 HEAD 请求。POST /dws/ticket、/dws/jhzz/package 及其他 DWS 入口不接入此次 key 校验。
¶ 3. 确认启用并测试
设备带上 key 后，请联系易抵达客服确认鉴权启用时间。启用后，用一票测试运单上报称重，按原接口的业务响应确认是否成功。
如果收到 HTTP 401，请检查设备是否传了完整 key、该 key 是否已保存且未撤销，以及设备传入的员工账号是否与 key 绑定的账号一致。