修改日期 | 修改人 | 备注 |
2020-05-12 17:41:02[当前版本] | 戴海林 | 其他原因... |
2020-05-11 15:12:07 | 戴海林 | 其他原因... |
2020-05-11 11:05:22 | 戴海林 | 格式调整 |
2020-05-11 11:00:56 | 戴海林 | 格式调整 |
设计文档-消息中心-冷战视频AI相关
一、需求描述
物联网 --> BIM 需要一个透传字段。
二、实现方案
1、通过模板的消息上报接口,增加一个appendData字段。
名称 |
消息中心报警上报接口 |
|||
类型 |
P OST |
|||
地址 |
http://njrgrj.imwork.net:8826/MessageCenter/ s endMessage ?token=XXXXXXXXXXXXX |
|||
方向 |
参数 |
类型 |
是否必填 |
备注 |
In |
app K ey |
String |
Y |
运营平台HTTP-OpenAPI提供给第三方接入的唯一标识符参数,同时与secret值用来做签名认证 |
In |
requestT ime |
String |
Y |
第三方应用发起请求时的时间戳采用UTC时间戳,自1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒)起至现在的总毫秒数 |
In |
templateCode |
String |
Y |
模板 编码(业务标识:包含了项目编码+报警类型+接收人员+接收方式) |
In |
templateParam |
J son |
N |
提供给 模板使用的键值对 |
In |
d ev C ode |
String |
N |
设备编码,2 5 位标准编码 |
In |
alarmL evel |
S tring |
Y |
报警等级 ( 103:高,102:中,101:低 ) |
I n |
alarmT ime |
String |
Y |
故障时间,时间格式Y YYY-MM-DD HH :mm : ss |
I n |
appendData |
String |
N |
透传给第三方的额外字段 |
In |
alarmMeasurePoint |
String |
N |
报警测点(物联网误报使用) |
In |
token |
S tring |
Y |
签名值,运营平台HTTP-OpenAPI服务端用来做token校验的参数 , 不拼接在POST数据的JSON串上 , 生成后把toke参数及值拼接在POST请求URL后面即可 |
out |
errorCode |
String |
Y |
错误编码,详情见附件1 |
out |
errorMessage |
String |
Y |
错误提示信息 |
参数示例 |
||||
In |
{ "app K ey":"f8524632", " requestT ime ":"1447756521042", " templateCode ": "T20200509154212191", " template P aram": { "K ey1 " : " value1 " , " Key2 " : " value2 " , "ItemList":[ { "IKey1":"value1", "Ikey2":"value2" }, { "IKey1":"value3", "Ikey2":"value4" }, ] }, " d ev C ode": "0020204002000301010010001", " alarmT ime": " 2 018 - 12 - 01 09 : 00 : 00", " alarmL evel": " 1 03", " appendData ": " 设备故障无法运行 " , } |
|||
O ut |
{ "errorCode":0, "errorMessage":"" } |
|||
T oken规则 |
token=MD5(请求URI+参数串+secret);参数串包括:接口业务参数、必传参数appkey和time。 注:加密的字符串统一采用UTF-8编码,结果为32位大写 token生成后把toke参数及值拼接在POST请求URL后面即可。 注:不是拼接在POST数据的JSON串上。 Appkey 、 secret 由运营平台进行提供 目前 可用 的 值: Appkey: lt0606lt |
2、CMQ推送,增加一个appendData字段。
名称 |
C MQ 推送公司BIM实时 报警消息 |
||
地址 |
|
||
方式 |
CMQ队列 推送 |
||
输出参数 |
|||
队列 |
bim_queue |
||
消息体 |
json 格式 |
||
消息 体说明 : |
|||
参数名 |
类型 |
必填(Y /N ) |
备注 |
id |
String |
N |
报警 消息id |
devCode |
String |
N |
设备 编号 |
messageInfo |
String |
N |
消息 内容 |
location |
S tring |
N |
位置 信息 |
alarm Type |
String |
N |
报警消息 类型 |
alarm Level |
S tring |
N |
报警 消息 级别 |
alarm Time |
String |
N |
报警消息 接收时间 |
source |
S tring |
N |
消息 来源 |
actionType |
String |
N |
报警消息 状态 |
remark |
S tring |
N |
备注 |
orderId |
String |
N |
工单id |
cameraIds |
List<String> |
N |
视频 地址列表 |
pictureUrls |
List<String> |
N |
图片 地址列表 |
appendData |
String |
N |
额外透传字段 |