QB-D-101-2008
QB-D-101-2008
名称 说明 根据请求的查询条件得到的终端统计数量。TERMCOUNT_RESULT包含以下几个子元素: TERMCOUNT_RESULT WORKING:产生业务的终端数量 REGISTED:已注册的终端数量DATENEW:当日新增终端数量 MONTHNEW:当月新增终端数量 TOTAL:累计终端数量 根据请求的查询条件得到的故障终端数量。TERMFAULT_RESULT包含如下几个子元素: TERMFAULT_RESULT DATENUM:查询日期当日产生故障的终端数量 MONTHNUM:查询月份当月产生终端数量 TOTAL:故障终端总数 根据请求的查询条件得到的不同状态的终端数量。 TERMSTATUS_RESULT包含如下TERMSTATUS_RESULT 几个子元素: NORMAL:状态正常终端数量 EXCEPTION:状态异常终端数量 FORBIDDEN:已禁用的终端数量
String 不定长 String 不定长 String 不定长 数据类型 长度(字节) 7.1.2.5. P_TERM_STATISTIC_QUERY查询终端统计信息接口
应用通过本接口,从M2M平台的数据库中查询单个终端的统计数据。该接口为同步接口,应用向M2M平台发出请求后,M2M平台从数据库记录中查询被请求终端的信息,然后返回给应用。
调用名称:PTermStatisticQuery
PTermStatisticQueryReq请求终端信息消息: 参数标识 消息格式 PTermStatisticQueryReq
33
QB-D-101-2008
名称 SID TIMESTAMP SERVICEID 消息体格式 消息流水号 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式
名称 TERMID DATERANGE 终端序列号 统计时间段。该元素有两个属性: (1) start:统计起始时间; (2) end:统计终止时间 ALARMCOUNT 终端发生的告警次数 LOGINCOUNT LASTLOGIN 终端登录次数 终端最后一次登录时间 0 0 0 说明 数据类型 String 长度(字节) 16 0 说明 数据类型 String String String 长度(字节) 16 18 16
PTermStatisticQueryRsp请求终端信息响应消息 参数标识 消息格式 PTermStatisticQueryRsp
名称 SID 说明 消息流水号 数据类型 String 长度(字节) 16 34
QB-D-101-2008
TIMESTAMP SERVICEID 消息体格式 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式
名称 TERMID ALARMCOUNT LOGINCOUNT LASTLOGIN
7.2. 应用系统提供给M2M平台的接口(M2M平台->M2M应用系统)
终端序列号 终端发生的告警次数 终端登录次数 终端最后一次登录时间 说明 数据类型 String 整数 整数 整数 长度(字节) 16 4 4 4 String String 18 16 7.2.1. 终端对应用上行消息接口
7.2.1.1. T_REGIST终端注册通知接口
终端向M2M平台注册成功后,M2M平台根据终端的订购关系,向为该终端提供业务的应用系统发送终端注册通知消息。
调用名称:TRegist
TRegistReq 应用系统接收M2M平台转发的终端注册请求
参数标识 消息格式 TRegistReq
名称 SID 消息流水号 说明 数据类型 String 长度(字节) 16 35
QB-D-101-2008
TIMESTAMP SERVICEID 消息体格式 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式
名称 TERMID IMEI IMSI 说明 终端序列号(即终端注册后,平台为其分配的序列号,或终端预置的合法序列号) 终端的IMEI号。长度16字节或15字节 终端的IMSI号 String String String 16 16或15 15 数据类型 长度(字节) String String 18 16
TRegistRsp终端注册应答信息: 参数标识 消息格式 TRegistRsp
名称 SID TIMESTAMP SERVICEID 消息体格式 消息流水号 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式
名称 返回注册结果 0:注册成功 RESULTCODE 1:登录成功,但需要下发配置 2:应用拒绝该终端的注册 其他:保留。 String 2 说明 数据类型 长度(字节) 说明 数据类型 String String String 长度(字节) 16 18 16 36
QB-D-101-2008
7.2.1.2. T_LOGIN终端向应用系统登录
当终端在M2M平台注册成功,并登录到M2M平台时,M2M平台根据终端的订购关系,向相应的应用系统发送该终端的登录信息。
调用名称:TLogin
TLoginReq 应用系统接收M2M平台转发的终端登录请求 参数标识 消息格式 TLoginReq
名称 SID TIMESTAMP SERVICEID 消息体格式 消息流水号 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 业务应用标识 未加密的消息体格式
名称 TERMID IMEI IMSI TERMVER CONFIGCRC 终端序列号 终端的IMEI号。长度16字节或15字节 终端的IMSI号 终端版本号 终端全部配置信息CRC32校验和:校验值为终端所有配置参数,如37
说明 数据类型 String String String 长度(字节) 16 18 16 说明 数据类型 String String String String String 长度(字节) 16 16或15 15 8 8