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 打开群聊的联调。