出站回调:
- 新增 warehouse_notify.json 文档(notify.ping/notify.reply),与 warehouse.json 互跳
- 回调体统一 { method, code, data },method 放 query,body 为业务数据
- MD5 签名: sign=MD5(appSecret+timestamp+bodyJson)
- 回调响应: {code:200} 成功,非200/非code:200 视为失败
- docs 页面支持模拟推送调试
搜索增强(searchStock/searchWarehouseStock):
- 直接查 stock_warehouse,不再依赖 stock_store
- 新增字段: gross_weight/box_spec/packing_requirements/prohibited_type
- 管理标识: is_sn_mgmt/is_shelf_life_mgmt/is_batch_mgmt
- 条码关联: wms_stock_barcodes
- 图片: wms_file_reference(business_type=stock)+wms_file,返回数组
- id 修正为 stock_warehouse.id
推送状态完善:
- handleApiMessage 增加 push_status 更新(2成功/3失败)
- 未配回调地址 → push_status=3 + error 原因
- 回调异常 catch 也更新 push_status=3 + 写日志
- 出站日志写入 wms_warehouse_log 表(WN-前缀)
消息列表:
- keyword 兼容 content/keyword,支持数组
- keyword 搜索 content/group_name/user_name 三列
- 支持 where+operator 结构化查询(parseWhereConditions)
- storeId=-1 查询无货主消息; storeId=0→IS NULL
- 日期范围: startDate/endDate
其他:
- silent 动作: AI 识别无需回复时跳过回执
- ai_enabled 灰度开关(群级)
- bindCode 文档修正
- store_name 改用 StoreWarehouse.store_remask
69 lines
4.5 KiB
JSON
69 lines
4.5 KiB
JSON
[
|
||
{
|
||
"version": "2026.08.01-warehouse-01",
|
||
"date": "2026-08-01",
|
||
"type": "added",
|
||
"summary": "新增 /warehouse 仓库开放 API 入口,支持仓库级外部适配器 HMAC-SHA256 签名鉴权调用,首批上线 index.ping 心跳 + store.list 货主列表",
|
||
"methods": [
|
||
"index.ping",
|
||
"store.list"
|
||
],
|
||
"notes": [
|
||
"POST /warehouse 为新增入口,独立于 /openapi(货主级),鉴权使用 interface_type_id=3 的仓库 API 应用(由 apiApp 模块管理)。",
|
||
"签名算法与 /openapi 完全一致:query 参数字典序 + body 拼接 → HMAC-SHA256 → hex。",
|
||
"时间戳 ±10 分钟有效期,Redis 缓存 API 应用配置 300 秒(缓存前缀 warehouse:api-app)。",
|
||
"无需 StoreWarehouse 合约关联,直接通过 api_app.warehouse_id 确定仓库上下文。",
|
||
"index.ping:无需 body 参数,返回 warehouse_id / app_key / server_time / status。",
|
||
"store.list:分页查询当前仓库下已授权的货主,通过 wms_store_warehouse 关联 wms_store,仅返回 auth_status=2 + store.status=1 + warehouse_use_status=1 的记录。",
|
||
"api_sign.js 改造:getApiAppConfigByAppKey 新增 interfaceTypeId 参数(默认 2 保持向后兼容),warehouse 入口传 3,查询增加 interface_type_id 条件并返回 warehouse_id。"
|
||
],
|
||
"module": "warehouse"
|
||
},
|
||
{
|
||
"version": "2026.08.03-warehouse-01",
|
||
"date": "2026-08-03",
|
||
"type": "added",
|
||
"summary": "新增仓库开放 API 站内信模块 inbox.push,支持外部系统将消息推入仓库站内信,WMS 异步转发到目标渠道(IM/API/webhook)",
|
||
"methods": [
|
||
"inbox.push"
|
||
],
|
||
"notes": [
|
||
"POST /warehouse?method=inbox.push,interface_type_id=3(仓库侧),使用 MD5 签名鉴权",
|
||
"warehouse_id 由验签后上下文注入,禁止外部传入(安全边界)",
|
||
"ext_id 格式:api:{appKey}:{requestId},用于幂等去重",
|
||
"target_url 仅允许 https://,禁止内网 IP(SSRF 防护)",
|
||
"推送 body 大小限制 64KB",
|
||
"异步推送使用 setImmediate,不阻塞响应;失败指数退避重试(30s→60s→120s,最多3次)",
|
||
"路由到 app/service/warehouseMethods/inbox.push → app/service/inbox/receiver.receive"
|
||
],
|
||
"module": "inbox"
|
||
},
|
||
{
|
||
"version": "2026-08-06",
|
||
"date": "2026-08-06",
|
||
"summary": "inbox.push 文档同步代码现状:移除废弃参数 sourceChannel/targetChannel/storeId,补齐缺失参数 groupId/groupName/userId/userName/content,更新错误码与描述",
|
||
"methods": [
|
||
"inbox.push"
|
||
],
|
||
"notes": [
|
||
"移除 sourceChannel / targetChannel / storeId 参数(代码中不存在)",
|
||
"补齐 groupId / groupName / userId / userName / content 参数",
|
||
"移除 targetChannel/targetUrl 相关错误码",
|
||
"新增 parent_id 校验、消息体 64KB 限制错误码",
|
||
"ext_id 自动组合为 api:{appKey}:{requestId}"
|
||
]
|
||
},
|
||
{
|
||
"version": "2026-08-07",
|
||
"date": "2026-08-07",
|
||
"summary": "inbox.push: source_type 硬编码为 api,移除 sourceType 入参(仓库 API 入站来源固定为 api,无需外部传入)",
|
||
"methods": [
|
||
"inbox.push"
|
||
],
|
||
"notes": [
|
||
"source_type 从 body.sourceType || 'api' 改为硬编码 'api'",
|
||
"文档移除 sourceType 参数,description 补注 source_type 固定为 api"
|
||
]
|
||
}
|
||
]
|