xj-platform/health-emergency/API文档-移动端接口.md

急救模块移动端 API 文档

🆕 本次变更（前端联调）

#	接口	变更类型	说明
1	GET /createGroupMagFirstAider	新增	急救员建群：不发起音视频通话，自动拉入关爱联络员+急救员1+急救员2
2	GET /order/searchExpert	补充	响应新增 phone 字段
3	GET /order/searchEmployee	修复	姓名、手机号、员工编号改为模糊搜索（之前为精确匹配）
4	GET /order/getActualGroupMemberList	新增	新增实际群成员列表接口，替换原 /order/getGroupMemberList。调用腾讯 IM 验证实际群成员，新增 isSelf 字段区分本人
5	GroupMemberVO 响应	扩展	新增 isSelf 字段：0=不是本人, 1=是本人

memberType 字典（群成员列表中用）：-1=发起人, 0=操作人员, 1=专业人员, 2=员工

---

基础信息
网关地址: http://{gateway-host}:{port}（前端加 /health-emergency 前缀）
服务直连: http://{host}:7011（调试用，不加前缀）
认证方式: 请求头 X-Access-Token: {token}
Content-Type: application/json; charset=utf-8
统一响应格式: {"success": bool, "message": "...", "code": 200, "result": {...}, "timestamp": ...}
日期格式: yyyy-MM-dd HH:mm:ss（东八区）

---

目录

1. 应急群聊拉人
2. 宣教资源

---

1. 应急群聊拉人 api/emergency

网关完整路径: /health-emergency/api/emergency

1.1 搜索专家（专业人员） GET /order/searchExpert

参数	类型	必填	说明
realname	String	否	姓名，模糊搜索
centerId	String	否	应急中心ID
excludeSessionId	String	否	群组ID，用于排除已在群中的人
pageNo	Integer	否	页码，默认1
pageSize	Integer	否	每页条数，默认10

// 响应 result
{
  "records": [
    {
      "userId": "xxx", "realname": "张医生", "avatar": "https://...",
      "type": "6", "centerId": "xxx",
      "post": "主任医师", "school": "北京大学", "edu": "博士",
      "goodAt": "心血管内科", "deptName": "急诊科", "phone": "13800000001"
    }
  ],
  "total": 50, "size": 10, "current": 1
}

字段	说明
userId	用户ID，邀请时传入 memberList
realname	姓名
avatar	头像
type	类型，"6"=专业人员
centerId	应急中心ID
post	职称
school	毕业院校
edu	学历
goodAt	擅长领域
deptName	科室
phone	手机号

1.2 搜索员工 GET /order/searchEmployee

参数	类型	必填	说明
realname	String	否	姓名，模糊搜索
orgCode	String	否	部门编码
workNo	String	否	工号
phone	String	否	手机号
excludeSessionId	String	否	群组ID，用于排除已在群中的人
pageNo	Integer	否	页码，默认1
pageSize	Integer	否	每页条数，默认10

// 响应 result
{
  "records": [
    {
      "userId": "xxx", "realname": "张三", "avatar": "https://...",
      "orgCode": "650000001001", "orgName": "新疆油田公司",
      "deptName": "安全环保部", "phone": "13800000000", "workNo": "A00123"
    }
  ],
  "total": 200, "size": 10, "current": 1
}

字段	说明
userId	用户ID，邀请时传入 memberList
realname	姓名
avatar	头像
orgCode	部门编码
orgName	单位名称（二级单位）
deptName	部门名称
phone	手机号
workNo	工号

1.3 创建群聊 GET /createGroupMag

参数	类型	必填	说明
name	String	是	群聊名称
longitude	String	是	经度
latitude	String	是	纬度
type	String	否	类型

返回 groupId（群组ID），作为后续拉人接口的入参。此接口会发起音视频通话。

1.4 创建群聊-急救员 GET /createGroupMagFirstAider 🆕

不发起音视频通话，建群后自动拉入关爱联络员和急救员（通过安眼系统查询）。

参数	类型	必填	说明
name	String	是	群聊名称
longitude	String	是	经度
latitude	String	是	纬度

返回结构与 createGroupMag 一致（CreateGroupMagVO），群成员 = 发起人 + 操作人员 + 专业人员 + 关爱联络员 + 急救员1 + 急救员2。

1.5 邀请进群 POST /addGroupUser

拉专家或员工加入应急群聊。

// Request Body
{
  "groupId": "1907659384834752513",
  "memberList": ["userId1", "userId2"],
  "memberType": 1
}

参数	类型	必填	说明
groupId	String	是	群组ID（即 createGroupMag 返回的 groupId）
memberList	List<String>	是	要邀请的用户ID列表，最多100个
memberType	Integer	否	0=专家/专业人员, 1=员工，默认0

// 响应
{"success": true, "message": "", "result": true}

已在群中的人员会自动跳过，不会报错。所有选中的人都在群中时返回失败。

1.6 移除群成员 POST /removeGroupUser

// Request Body
{ "groupId": "1907659384834752513", "memberList": ["userId1"] }

参数	类型	必填	说明
groupId	String	是	群组ID
memberList	List<String>	是	要移除的用户ID列表

// 响应
{"success": true, "message": "", "result": true}

只能移除后续拉入的协助人员，不能移除发起人和初始操作/专业人员。

1.7 群成员列表 GET /order/getGroupMemberList

⚠️ 本接口仅查本地 DB，不验证腾讯 IM。建议改用 1.8 /order/getActualGroupMemberList。

参数	类型	必填	说明
sessionId	String	是	群组ID

// 响应 result
[
  { "orderId": "...", "userId": "发起人id", "userName": "李四", "avatar": "https://...", "phone": "13800000001", "isGroupMember": 1, "memberType": -1 },
  { "orderId": "...", "userId": "操作人员id", "userName": "王五", "avatar": "https://...", "phone": "13800000002", "isGroupMember": 1, "memberType": 0 },
  { "orderId": "...", "userId": "专业人员id", "userName": "张医生", "avatar": "https://...", "phone": "13800000003", "isGroupMember": 1, "memberType": 1 },
  { "orderId": "...", "userId": "员工id", "userName": "张三", "avatar": "https://...", "phone": "13800000004", "isGroupMember": 1, "memberType": 2 },
  { "orderId": "...", "userId": "其他专业人id", "userName": "赵医生", "avatar": "https://...", "phone": "13800000005", "isGroupMember": 0, "memberType": 1 }
]

字段	说明
orderId	应急单ID
userId	用户ID
userName	姓名
avatar	头像
phone	手机号
isGroupMember	1=在群中, 0=可邀请
memberType	-1=发起人, 0=操作人员, 1=专业人员, 2=员工

1.8 实际群成员列表 GET /order/getActualGroupMemberList 🆕

与 1.7 的区别：本接口先查本地参与人员，再调用腾讯 IM get_group_member_info API 获取群内实际成员，以 IM 成员为准取交集，确保返回的都是 IM 群中真实存在的成员。不过滤本人，通过 isSelf 标识。

参数	类型	必填	说明
sessionId	String	是	群组ID

// 响应 result（与 getGroupMemberList 格式完全一致，但不过滤本人）
[
  { "orderId": "...", "userId": "当前用户id", "userName": "我", "avatar": "https://...", "phone": "13800000000", "isGroupMember": 1, "memberType": 0, "isSelf": 1 },
  { "orderId": "...", "userId": "发起人id", "userName": "李四", "avatar": "https://...", "phone": "13800000001", "isGroupMember": 1, "memberType": -1, "isSelf": 0 },
  { "orderId": "...", "userId": "专业人员id", "userName": "张医生", "avatar": "https://...", "phone": "13800000003", "isGroupMember": 1, "memberType": 1, "isSelf": 0 }
]

字段	说明
orderId	应急单ID
userId	用户ID
userName	姓名
avatar	头像
phone	手机号
isGroupMember	始终为 1（所有返回成员均经 IM 验证在群中）
memberType	-1=发起人, 0=操作人员, 1=专业人员, 2=员工
isSelf	0=不是本人, 1=是本人

建议：前端优先使用本接口获取群成员列表，1.7 接口后续可淘汰。

1.9 memberType 字典

值	含义	场景
-1	发起人	创建应急的人
0	操作人员	应急中心调度员
1	专业人员	专家/医生
2	员工	普通员工（被拉入群）

典型调用流程

应急就医（带音视频通话）：

1. 创建群聊
   GET /health-emergency/api/emergency/createGroupMag?name=xxx&longitude=xxx&latitude=xxx

2. 查看当前成员 → 搜索要拉的人 → 确认邀请 → 移除成员 → 刷新列表
   GET /health-emergency/api/emergency/order/getActualGroupMemberList?sessionId={groupId}
   （以下步骤同急救员流程）

急救员（不发起通话，自动拉关爱/急救员）：

1. 创建群聊
   GET /health-emergency/api/emergency/createGroupMagFirstAider?name=xxx&longitude=xxx&latitude=xxx
   → 自动拉入：发起人 + 操作人员 + 专业人员 + 关爱联络员 + 急救员1 + 急救员2

2. 查看当前成员（🔀 替换原 /order/getGroupMemberList）
   GET /health-emergency/api/emergency/order/getActualGroupMemberList?sessionId={groupId}
   → 返回经腾讯IM验证的实际群成员，新增 isSelf 字段区分本人

3. 搜索要拉的人
   GET /health-emergency/api/emergency/order/searchExpert?realname=张&excludeSessionId={groupId}
   GET /health-emergency/api/emergency/order/searchEmployee?realname=李&excludeSessionId={groupId}
   → 展示搜索结果，用户勾选

4. 确认邀请
   POST /health-emergency/api/emergency/addGroupUser
   {"groupId": "{groupId}", "memberList": ["id1","id2"], "memberType": 0}

5. 移除成员
   POST /health-emergency/api/emergency/removeGroupUser
   {"groupId": "{groupId}", "memberList": ["id1"]}

6. 刷新成员列表（🔀 替换原 /order/getGroupMemberList）
   GET /health-emergency/api/emergency/order/getActualGroupMemberList?sessionId={groupId}

---

2. 宣教资源 api/emergency/firstAid/resource

网关完整路径: /health-emergency/api/emergency/firstAid/resource

2.1 根据宣教ID查询详情 GET /resource/queryById

参数	类型	必填	说明
id	String	是	宣教资源ID

// 响应 result
{
  "id": "...",
  "title": "心肺复苏指南",
  "summary": "摘要简介",
  "contentType": "IMAGE_TEXT",
  "categoryId": "cat1",
  "categoryName": "心肺复苏",
  "applicableScenario": "适用场景",
  "tags": "tag1,tag2",
  "tagNameList": ["成人", "初级"],
  "content": "<h1>富文本HTML正文</h1>",
  "coverImage": "https://example.com/cover.jpg",
  "fileUrl": "[\"https://example.com/file1.pdf\"]",
  "viewCount": 100,
  "favoriteCount": 20,
  "isFavorited": false,
  "effectiveTime": "2026-07-01 00:00:00",
  "expiryTime": "2026-12-31 23:59:59",
  "createTime": "2026-07-01 10:00:00",
  "updateTime": "2026-07-05 14:30:00"
}

字段	类型	说明
id	String	资源ID
title	String	标题
summary	String	摘要/简介
contentType	String	内容类型：IMAGE_TEXT/VIDEO/AUDIO/PDF
categoryId	String	分类ID
categoryName	String	分类名称
applicableScenario	String	适用场景
tags	String	标签ID（逗号分隔）
tagNameList	List<String>	标签名称列表
content	String	富文本正文HTML
coverImage	String	封面图URL
fileUrl	String	附件URL列表（JSON数组字符串）
viewCount	Integer	浏览次数
favoriteCount	Integer	收藏次数
isFavorited	Boolean	当前用户是否已收藏
effectiveTime	Date	生效时间
expiryTime	Date	失效时间
createTime	Date	创建时间
updateTime	Date	更新时间