order-im-group.md 1.9 KB

订单 IM 群聊标识(2026-10-26)

App/IM 创建群聊、维护商家/骑手/用户成员后,将群标识保存到真实订单。后端不代建群。

保存接口

POST /system/order/imGroup,请求头 token: <App 登录 Token>、Content-Type: application/json。

{
  "ddId": "176000000000000001",
  "imGroupId": "im-order-room-001"
}
  • ddId:真实子单业务订单号,字符串;多店批次父单号、配送组 ID 不能代替。
  • imGroupId:非空字符串,最长 200 字符,原样保存。
  • 仅下单用户、当前接单骑手以及有门店访问权限的商家可保存。方法使用 @Anonymous 放行后台 Spring Security,同时由 @Auth 校验 App 登录,不属于免登录接口。
  • 成功返回 code=200。同一标识重复保存成功;传入新值会更新已有标识。无清空操作。订单无群聊时字段为空,历史订单兼容。
  • 接口只修改 im_group_id,不修改履约/支付状态,不调用 IM 外部接口。

查询返回位置

接口 群标识位置
GET /system/order/getorderxq?ddid=... data.imGroupId
GET /system/order/{id} data.imGroupId
GET /system/orderQsOprate/getOrderDetial?ddId=... data.imGroupId
GET /system/orderQsOprate/orderList data.records[].imGroupId
GET /system/order/getqsorderlist、/getqishouorderlist data[].imGroupId
GET /system/multiStoreCheckout/rider/tasks 普通单 data.records[].imGroupId、legacyOrder.imGroupId
同接口的多店组、GET /system/multiStoreCheckout/groups/{groupId} members[].imGroupId、members[].legacyOrder.imGroupId

多店组没有单一群聊标识,每个真实子单关联自己的群。数据库部署前需人工执行 updatesql/sql.md 的本次新增列语句;本地测试不代替实际 IM 建群、邀请成员及 App 打开群聊的联调。