应急模块

会昌企业帮接口文档V1.0

总述

1.简介


文档介绍.


2.注意

  • 默认年月日时分秒的日期格式,yyyy-MM-dd HH:mm:ss

3.模板


  • 接口地址
  • 功能说明
  • 请求参数
  • 请求示例
  • 响应参数
  • 响应示例

4.统一返回结果集格式

data字段中为实际返回的数据内容

{
    "code": 200,
    "msg": "成功",
    "data": { }
}

5.统一返回结果错误码

状态码 含义
200 成功
500 失败
401 未授权

6.用户授权凭证

用户授权token分为两种,一种是accessToken,用户登录成功后生成,在每次的接口请求中需在head中携带accessToken,另一种为refreshToken,每次请求接口刷新产生新的refreshToken并返回写于head中。

7.分页统一返回数据格式

{
    "success": true,
    "code": 200,
    "message": "成功",
    "data": {
         "total": 1,  
         "size": 10,
         "current": 1,
         "pages": 1
        }
    }
}
参数名 含义
total 总记录数
size 每页记录数(默认10条)
current 当前页码(从1开始)
pages 总页数

会昌企业帮接口

1.应急模块

1.1 应急通讯录

API地址

接口地址 请求方式
/api/app/emergency/orgList POST

功能说明

  • 获取所有应急单位列表

请求参数

参数名 含义 是否必填
orgName 单位名称 N

请求示例

 {
    "orgName":"研发部"
}

响应参数

名称 含义
orgId 单位ID
organizationName 单位名称
userCount 单位人数

响应示例

{
    "msg": "操作成功",
    "code": 0,
    "data": [
        {
        "orgId": 10,
        "organizationName": "赣州智研院",
        "userCount": 30
        }
    ] 
}
  }

1.2 单位通讯录

API地址

接口地址 请求方式
/api/app/emergency/orgContacts POST

功能说明

  • 获取指定应急单位下成员列表

请求参数

参数名 含义 是否必填
orgId 单位ID Y
searchKey 姓名(支持模糊搜索) N

请求示例

 {
    "orgId":2,
    "searchKey":"谢宝发"
}

响应参数

名称 含义
organizationId 单位ID
organizationName 单位名称
userList 用户列表

userList解释

名称 含义
userId 用户ID
username 用户名
trueName 真实姓名
phone 手机号
imId 即时通信ID
avatar 头像

响应示例

{
    "msg": "操作成功",
    "code": 0,
    "data": {
        "orgId": 10,
        "organizationName": "赣州智研院",
        "userList": [
            {
                "userId": 2,
                "username": "xiebaofa",
                "trueName": "谢宝发",
                "phone":"17324386047",
                "imId":
            }
        ]
    }
}
  }

1.3 通讯人员详情

API地址

接口地址 请求方式
/api/app/emergency/personnelDetails POST

功能说明

  • 获取通讯人员详情

请求参数

参数名 含义 是否必填
userId 用户ID Y

请求示例

  {
      "userId":2
  }

响应参数

名称 含义
userId 用户ID
username 用户名
trueName 真实姓名
phone 手机号
imId 即时通信ID
avatar 头像
sex 性别:0-男,1-女
officeTel 办公电话
offieAddr 办公地址
post 职务
orgName 单位名

响应示例

{
    "msg": "操作成功",
    "code": 0,
    "data": {
        "userId": 2,
        "username": "xiebaofa",
        "avatar": null,
        "sex": 0,
        "phone": "17324386047",
        "trueName": "谢宝发",
        "officeTel": null,
        "offieAddr": "产业园",
        "orgId": "10",
        "post": "java工程师",
        "orgName": "赣州智研院"
    }
}

1.4 建群

API地址

接口地址 请求方式
/api/app/emergency/group/create POST

功能说明

  • 创建应急救援群聊

请求参数

参数名 含义 是否必填
groupName 群名 Y
groupOwner 群主 Y
members 群成员 Y

请求示例

  {
    "groupName": "紧急救援组001",
    "groupOwner": 1,
    "members": "2,3"
  }

响应参数

名称 含义

响应示例

{
    "msg": "添加成功",
    "code": 0
}

1.5.1 编辑群

API地址

接口地址 请求方式
/api/app/emergency/group/update POST

功能说明

  • 更新群名称和群成员

请求参数

参数名 含义 是否必填
groupName 群名 Y
groupId 群ID Y
members 群成员 Y
groupOwner 群主 Y

请求示例

{
  "groupId":3,
  "groupName": "紧急救援组001",
  "members": "2",
  "groupOwner":2
}

响应参数

名称 含义

响应示例

{
    "msg": "修改成功",
    "code": 200
}

1.5.2 解散群

API地址

接口地址 请求方式
/api/app/emergency/group/remove POST

功能说明

  • 解散该群

请求参数

参数名 含义 是否必填
groupId 群ID Y

请求示例

{
  "groupId":3
}

响应参数

名称 含义

响应示例

{
    "msg": "解散成功",
    "code": 200
}

1.6 群详情

API地址

接口地址 请求方式
/api/app/emergency/group/get POST

功能说明

  • 获取群详情

请求参数

参数名 含义 是否必填
groupId 群ID Y

请求示例

{
  "groupId":3
}

响应参数

名称 含义
groupId 群ID
groupName 群名称
groupOwner 群主
members 群成员

响应示例

{
    "msg": "操作成功",
    "code": 200,
    "data": {
        "groupId": 3,
        "groupName": "紧急救援组001",
        "groupOwner": 1,
        "members": [
            {
                "id": 1,
                "name": "林哥"
            },
            {
                "id": 2,
                "name": "谢宝发"
            }
        ]
    }
}

1.7 群列表

API地址

接口地址 请求方式
/api/app/emergency/group/list POST

功能说明

  • 获取当前用户所有群聊列表

请求参数

参数名 含义 是否必填
groupOwner 群主ID Y

请求示例

{
  "groupOwner":1
}

响应参数

名称 含义
groupId 群ID
groupName 群名称
groupOwner 群主
members 群成员

响应示例

 {
    "msg": "操作成功",
    "code": 200,
    "data": {
        "groupId": 3,
        "groupName": "紧急救援组001",
        "groupOwner": 1,
        "members": "2",
        "state": 0,
        "deleted": 0,
        "createTime": "2021/09/22 15:33:33",
        "updateTime": "2021/09/22 15:53:44"
    }
 }

1.8 应急通讯列表

API地址

接口地址 请求方式
/api/app/chatRecord/list POST

功能说明

  • 获取当前用户所有历史的通讯人列表

请求参数

参数名 含义 是否必填
userId 用户ID Y

请求示例

{
  "userId":3637
}

响应参数

名称 含义
id 用户ID或者群ID
name 用户名称或者群名称
type 消息类型:0-个人消息,1-群消息

messages解释

名称 含义
message_type 消息类型:peer_message-个人消息,channel_message-群消息
payload 消息内容
payloadType 消息格式:0-即时消息;1-语音聊天
ms 消息时间(毫秒)

响应示例

{
    "msg": "操作成功",
    "code": 200,
    "data": [
        {
            "id": "2",
            "name": "谢宝发",
            "type": 0,
            "messages": [
                {
                    "src": "2",
                    "dst": "2",
                    "message_type": "peer_message",
                    "payload": "您好",
                    "payloadType": "0",
                    "ms": 1632644357757
                }
            ]
        },
        {
            "id": "2853",
            "name": "周杰伦",
            "type": 0,
            "messages": [
                {
                    "src": "2853",
                    "dst": "2",
                    "message_type": "peer_message",
                    "payload": "方法的方法",
                    "payloadType": "0",
                    "ms": 1632644651129
                }
            ]
        }
    ]
}

1.9 危化品知识库

API地址

接口地址 请求方式
/api/app/emergency/dangerousChemicals/page POST

功能说明

  • 危化品列表(支持搜索)

请求参数

参数名 含义 是否必填
name 危化品中文名 Y
page 页码 Y
limit 页大小 Y

请求示例

{
  "name":"一甲胺",
  "page":1,
  "limit":10
}

响应参数

名称 含义
count 总记录数
id ID
name 危化品名称
alias 危化品别名
type 类别
enName 英文名
stability 稳定性
dangerFlag 危险标记
appearance 外观气味
solubility 溶解性

响应示例

{
    "msg": "操作成功",
    "code": 200,
    "count":1344,
    "data": [
        {
            "id": 1,
            "name": "一甲胺",
            "alias": "氨基甲烷;甲胺",
            "type": "胺类",
            "enName": "monomethylamine",
            "stability": "1",
            "dangerFlag": "4",
            "appearance": "无色气体",
            "solubility": "易溶于水",
            "deleted": 0,
            "createdTime": "2021/09/24 14:11:21",
            "updatedTime": "2021/09/24 14:13:45"
        }
    ]
}

1.9.1 危化品知识库(分组)

API地址

接口地址 请求方式
/api/app/emergency/dangerousChemicals/listGroup POST

功能说明

  • 危化品列表(支持搜索,无搜索条件则查询按组全部危化品)

请求参数

参数名 含义 是否必填
name 危化品中文名 N
pinyinInitialLetter 拼音首字母 N

请求示例

{
  "name":"一甲胺",
  "pinyinInitialLetter":"1"
}

响应参数

名称 含义
letter 首字母
list 危化品列表

list参数解释

名称 含义
id ID
name 危化品名称
alias 危化品别名
type 类别
enName 英文名
casNo cas号
internationalNo 国际编号
formula 分子式
molecularweight 分子量
density 密度
meltingpoint 熔点
boilingpoint 沸点
flashpoint 闪点
solubility 溶解性
dangerFlag 危险标记
steam 蒸气压
appearance 外观与性状
stability 稳定性
emergencyMonitoringM 现场应急监测方法
laboratoryMonitoringM 实验室监测方法
protectiveMeasures 防护措施
toxicologicalIAEB 毒理学资料及环境行为
spillContingency 泄露应急处理方法
environmentalS 环境标准
healthHazards 健康危害
useage 主要用途
firstAidMeasures 急救措施

响应示例

{
    "msg": "操作成功",
    "code": 200,
    "data": [
        {
            "letter": "A",
            "list": [
                {
                    "id": 142,
                    "name": "阿特拉津",
                    "alias": "2-氯-4-乙氨基-6-异丙氨基-1,3,5-三嗪;莠去津",
                    "type": null,
                    "enName": "Atrazine;2-Chloro-4-ethylamino-6-isopropylamino-s-triazine",
                    "casNo": "1912-24-9",
                    "internationalNo": "61898",
                    "formula": "C<sub>8</sub>H<sub>14</sub>ClN<sub>5</sub>",
                    "molecularweight": "215.72",
                    "density": "相对密度(水=1)1.2(20℃)",
                    "meltingpoint": "171~174℃ 沸点:分解",
                    "boilingpoint": "",
                    "flashpoint": "",
                    "steam": "0.399×10<sup>-7</sup>kPa(20℃)",
                    "emergencyMonitoringM": "",
                    "laboratoryMonitoringM": "<p>气相色谱法《水和废水标准检验方法》15版,中国建筑工业出版社,1985年<br>高效液相色谱法(中国环境监测总站,水质)</p>",
                    "protectiveMeasures": "<p>  呼吸系统防护:生产操作或农业使用时,必须佩戴防毒口罩。紧急事态抢救或逃生时,应该佩戴自给式呼吸器。<br> 。</p>",
                    "toxicologicalIAEB": "<p>  急性毒性:LD<sub>50</sub>672mg/kg(大鼠经口);850mg/kg(小鼠经口);750mg/kg(兔经口);7500mg/kg(兔经皮)<br>  刺激性:人经皮500mg,中等刺激;人经眼100mg,严重刺激。</p><p>  危险特性:不易燃烧。受高热分解,放出有毒的烟。<br>  燃烧(分解)产物:一氧化碳、二氧化碳、氮氧化物、氯化氢。</p>",
                    "spillContingency": "<p>  隔离泄漏污染区,周围设警告标志,建议应急处理人员戴自给式呼吸器,穿化学防护服。不要直接接触泄漏物,小心扫起,避免扬尘,运至废物处理场所。用水刷洗泄漏污染区,经稀释的污水放入废水系统。如大量泄漏,收集回收或无害处理后废弃。</p>",
                    "environmentalS": "<type>空气</type><p><td>前苏联 </td><td>车间空气中有害物质的最高容许浓度</td><td>2mg/m<sup>3</sup> </td></p><type>空气</type><p><td>前苏联(1978)</td><td>环境空气中最高容许浓度</td><td>0.02mg/m<sup>3</sup></td></p><type>水质</type><p><td><sup>中国(GHZB1-1999)</sup></td><td><sup>地面水环境质量标准(I、II、III类水域)</sup></td><td><sup>0.003mg/L</sup></td></p><type>水质</type><p><td>前苏联(1978)</td><td>渔业用水中最高容许浓度</td><td>5μg/L</td></p>",
                    "healthHazards": "<p>  侵入途径:吸入、食入、经皮吸收。<br>  健康危害:本品对皮肤和眼睛有刺激作用。属低毒除草剂。动物实验致癌、致畸为阳性。对人有致突变作用。</p>",
                    "useage": "农用除草剂",
                    "firstAidMeasures": "<p>  皮肤接触:用肥皂水及清水彻底冲洗。就医。<br>  眼睛接触:拉开眼睑,用流动清水冲洗15分钟。就医。<br>  吸入:脱离现场至空气新鲜处。就医。<br>  食入:误服者,饮适量温水,催吐。洗胃。就医。</p><p>  灭火方法:泡沫、干粉、砂土。</p>",
                    "stability": "稳定",
                    "dangerFlag": "15(有害品,远离食品)",
                    "appearance": "纯品为无色结晶,原药为白色粉末",
                    "solubility": "难溶于水,微溶于多数有机溶剂",
                    "deleted": 0,
                    "createdTime": "2021/10/20 10:19:41",
                    "updatedTime": "2021/10/20 14:46:30",
                    "pinyinInitialLetter": "A"
                }
            ]
        }
    ]
}

1.10 危化品详情

API地址

接口地址 请求方式
/api/app/emergency/dangerousChemicals/detail POST

功能说明

  • 危化品列表(支持搜索)

请求参数

参数名 含义 是否必填
id 危化品id Y

请求示例

{
  "id": 1
}

响应参数

名称 含义
id ID
name 危化品名称
alias 危化品别名
type 类别
enName 英文名
casNo cas号
internationalNo 国际编号
formula 分子式
molecularweight 分子量
density 密度
meltingpoint 熔点
boilingpoint 沸点
flashpoint 闪点
solubility 溶解性
dangerFlag 危险标记
steam 蒸气压
appearance 外观与性状
stability 稳定性
emergencyMonitoringM 现场应急监测方法
laboratoryMonitoringM 实验室监测方法
protectiveMeasures 防护措施
toxicologicalIAEB 毒理学资料及环境行为
spillContingency 泄露应急处理方法
environmentalS 环境标准
healthHazards 健康危害
useage 主要用途
firstAidMeasures 急救措施

响应示例

{
    "msg": "操作成功",
    "code": 200,
    "data": {
        "id": 2,
        "name": "丙酸戊酯",
        "alias": "丙酸正戊酯",
        "type": null,
        "enName": "amyl propionate;pentyl prorionate",
        "casNo": "624-54-4",
        "internationalNo": "33597",
        "formula": "C<sub>8</sub>H<sub>16</sub>O<sub>2</sub>;CH<sub>3</sub>CH<sub>2</sub>COO(CH<sub>2</sub>)<sub>4</sub>CH<sub>3</sub>",
        "molecularweight": "144.21",
        "density": "相对密度(水=1)0.88(25℃);相对密度(空气=1)5.0",
        "meltingpoint": "-73.1℃ ",
        "boilingpoint": "106.2℃",
        "flashpoint": "",
        "steam": "1.33kPa/46.3℃ 闪点:41℃/开杯",
        "emergencyMonitoringM": "",
        "laboratoryMonitoringM": "<p>气相色谱法,参照《分析化学手册》(第四分册,色谱分析),化学工业出版社</p>",
        "protectiveMeasures": "<p>  呼吸系统防护:一般不需要特殊防护,高浓度接触时可佩戴自吸过滤式防毒面具(半面罩)。紧急事态抢救或撤离时,建议佩戴隔离式呼吸器。<br>  眼睛防护:戴化学安全防护眼镜。<br>  身体防护:穿防静电工作服。<br>  手防护:戴防苯耐油手套。<br>  其它:工作现场严禁吸烟。工作毕,淋浴更衣。特别注意眼和呼吸道的防护。</p>",
        "toxicologicalIAEB": "<p>  毒性:属低毒类。<br>  危险特性:易燃,遇明火、高热能引起燃烧爆炸。与氧化剂可发生反应。<br>  燃烧(分解)产物:一氧化碳、二氧化碳。</p>",
        "spillContingency": "<p>  迅速撤离泄漏污染区人员至安全区,并进行隔离,严格限制出入。切断火源。建议应急处理人员戴自给正压式呼吸器,穿消防防护服。不要直接接触泄漏物。尽可能切断泄漏源,防止进入下水道、排洪沟等限制性空间。小量泄漏:用砂土可其它不燃材料吸附或吸收。大量泄漏:构筑围堤或挖坑收容;用泡沫覆盖,降低蒸气灾害。用防爆泵转移至槽车或专用收集器内,回收或运至废物处理场所处置。</p>",
        "environmentalS": "",
        "healthHazards": "<p>  侵入途径:吸入、食入。<br>  健康危害:在工业生产中未发现对人的危害。给动物致死剂量时发生皮毛粗糙、共济失调、气急、呼吸困难、抽搐和体温降低等表现。</p>",
        "useage": "用作溶剂,还用于制油漆及香料",
        "firstAidMeasures": "<p>  皮肤接触:脱去被污染的衣着,用肥皂水和清水彻底冲洗皮肤。<br>  眼睛接触:提起眼睑,用流动清水或生理盐水冲洗。就医。<br>  吸入:迅速脱离现场至空气新鲜处。保持呼吸道通畅。如呼吸困难,给输氧。如呼吸停止,立即进行人工呼吸。就医。<br>  食入:饮足量温水,催吐,就医。</p><p>  灭火方法:喷水冷却容器,可能的话将容器从火场移至空旷处。灭火剂:泡沫、二氧化碳、干粉、砂土。</p>",
        "stability": "稳定",
        "dangerFlag": "7(易燃液体)",
        "appearance": "无色液体。有类似苹果的香味",
        "solubility": "不溶于水,溶于醇、醚,可混溶于多数有机溶剂",
        "deleted": 0,
        "createdTime": "2021/10/20 10:19:40",
        "updatedTime": "2021/10/20 17:25:18",
        "pinyinInitialLetter": "B"
    }
}

1.11 应急知识列表

API地址

接口地址 请求方式
/api/app/emergency/knowledge/list POST

功能说明

  • 应急知识列表

请求参数

参数名 含义 是否必填
title 标题 N

请求示例

{
"title":"电梯"
}

响应参数

名称 含义
knowledgId ID
content 内容
title 标题

响应示例

{
    "msg": "操作成功",
    "code": 200,
    "data": [
        {
            "knowledgId": 1,
            "content": "电梯逃生知识",
            "title": "电梯"
        }
    ]
}

1.12 应急知识详情

API地址

接口地址 请求方式
/api/app/emergency/knowledge/detail POST

功能说明

  • 应急知识详情

请求参数

参数名 含义 是否必填
knowledgId ID

请求示例

{
    "knowledgId":2
}

响应参数

名称 含义
knowledgId ID
content 内容
title 标题

响应示例

{
    "msg": "操作成功",
    "code": 200,
    "data": {
        "knowledgId": 2,
        "content": "溺水自救尝试",
        "title": "溺水"
    }
}

1.13.1 应急事故详情

API地址

接口地址 请求方式
/api/app/emergency/accidentDetail POST

功能说明

  • 应急知识详情

请求参数

参数名 含义 是否必填
accidentId ID Y

请求示例

{
    "accidentId":1
}

响应参数

名称 含义
accidentId ID
title 事故标题
type 类型
location 地点
longitude 经度
latitude 纬度
pollutant 污染物
level 等级
occurTime 发生时间
content 事件描述(上报内容)

响应示例

{
    "msg": "操作成功",
    "code": 200,
    "data":
        {
            "accidentId": 16,
            "title": "危险化学品泄露专项事故",
            "type": "危险化学品泄露专项",
            "location": "石磊工厂",
            "longitude": "114",
            "latitude": "37",
            "pollutant": "二氧化硫",
            "level": "一般",
            "occurTime": "2022/01/19 16:35:00",
            "content": "危险化学品泄露"
        }
}

1.13.2 应急事故详情列表

API地址

接口地址 请求方式
/api/app/emergency/accidentDetailList POST

功能说明

  • 应急知识详情

请求参数

参数名 含义 是否必填

请求示例



响应参数

名称 含义
accidentId ID
title 事故标题
type 类型
location 地点
longitude 经度
latitude 纬度
pollutant 污染物
level 等级
occurTime 发生时间
content 事件描述(上报内容)

响应示例

{
    "msg": "操作成功",
    "code": 200,
    "data": [
        {
            "accidentId": 16,
            "title": "危险化学品泄露专项事故",
            "type": "危险化学品泄露专项",
            "location": "石磊工厂",
            "longitude": "114",
            "latitude": "37",
            "pollutant": "二氧化硫",
            "level": "一般",
            "occurTime": "2022/01/19 16:35:00",
            "content": "危险化学品泄露"
        }
    ]
}

1.13.3 应急事故上报

API地址

接口地址 请求方式
/api/app/emergency/submitAccident POST

功能说明

  • 应急事故上报

请求参数

参数名 含义 是否必填
type 事故类型 Y
level 事故等级 Y
pollutant 污染物 N
location 发生地点 Y
latitude 纬度 Y
longitude 经度 Y
occurTime 发生时间 Y
person 上报人 Y
phone 电话 Y
content 上报内容 Y

请求示例

{
  "type": "危险化学品泄露专项",
  "level": "一般",
  "pollutant": "二氧化硫",
  "location": "石磊工厂",
  "latitude": "37",
  "longitude": "114",
  "occurTime": "2022/01/19 16:35:00",
  "person": "张三",
  "phone": "13188888888",
  "content": "危险化学品泄露"
}

响应参数

名称 含义
accidentId ID
title 事故标题
type 类型
location 地点
longitude 经度
latitude 纬度
pollutant 污染物
level 等级
occurTime 发生时间
content 事件描述

响应示例

{
    "msg": "添加成功",
    "code": 200
}

1.14 应急通讯个人聊天记录

API地址

接口地址 请求方式
/api/app/chatRecord/withUser POST

功能说明

  • 获取当前用户与指定人员的聊天记录

请求参数

参数名 含义 是否必填
userId 用户ID Y
target 对方userId Y
offset 偏移量(默认为0,每次加100) Y

请求示例

{
  "userId":3637,
  "target":2,
  "offset":100
}

响应参数

名称 含义
userId 用户ID
userName 用户名

messages解释

名称 含义
message_type 消息类型:peer_message-个人消息,channel_message-群消息
payload 消息内容
payloadType 消息格式:0-消息;1-语音聊天
ms 消息时间(毫秒)

响应示例

{
    "msg": "操作成功",
    "code": 0,
    "data": {
            "userId": "2853",
            "userName": "周杰伦",
            "messages": [
                {
                   "src": "2853",
                   "srcName": "周杰伦",
                   "dst": "4",
                   "dstName": "黄炎希",
                   "message_type": "peer_message",
                   "payload": "照顾古风",
                   "payloadType": "0",
                   "ms": 1632795964587
                }
            ]
        }
}

1.15 应急通讯群聊天记录

API地址

接口地址 请求方式
/api/app/chatRecord/group POST

功能说明

  • 获取指定群聊内的聊天记录

请求参数

参数名 含义 是否必填
userId 用户ID Y
target 群ID Y
offset 偏移量(默认为0,每次加100) Y

请求示例

{
  "userId":3637,
  "target":2,
  "offset":100
}

响应参数

名称 含义
groupId 群ID
groupName 群名

messages解释

名称 含义
message_type 消息类型:peer_message-个人消息,channel_message-群消息
payload 消息内容:带EndCall的表示语音消息
ms 消息时间(毫秒)

响应示例

{
    "msg": "操作成功",
    "code": 0,
    "data": {
            "groupId": "2853",
            "groupName": "智研院",
            "messages": [
                {
                    "src": "2853",
                    "dst": "3637",
                    "message_type": "peer_message",
                    "payload": "{\"Cmd\":\"EndCall\"}",
                    "ms": 1632386568509
                }
            ]
        }
}