资源描述
中国移动通信有限公司 发布
中国移动通信企业标准
QB-╳╳-╳╳╳-╳╳╳╳
亲情通业务接口规范
Family Locating Service Interface Specification
版本号:V1.0.0
╳╳╳╳-╳╳-╳╳发布
╳╳╳╳-╳╳-╳╳实施
目 录
1 范围 1
2 规范性引用文件 1
3 术语、定义和缩略语 1
3.1 符号 2
3.2 语法说明 2
4 业务接口协议组成 3
4.1 SMS接口 3
4.2 HTTP接口 3
5 接口通信协议 3
5.1 数据类型定义 3
5.2 报文结构定义 3
5.2.1 SMS报文定义(发起、应答) 3
5.2.2 HTTP报文定义 4
5.3 协议使用说明 6
5.4 双方交互的协议说明 6
5.4.1 登录请求 6
5.4.2 登录应答 9
5.4.3 设置呼入号码请求 14
5.4.4 设置呼入号码应答 15
5.4.5 缺电报警/关机报警请求 17
5.4.6 缺电报警/关机报警应答 S06 18
5.4.7 查询请求 20
5.4.8 查询应答 21
5.4.9 设置Http通信URL(群发) 23
5.4.10 设置HTTP通信URL应答 24
5.4.11 设置普通按键/SOS按键请求 24
5.4.12 设置普通按键/SOS按键应答 26
5.4.13 设置CELLID定位授权参数请求 27
5.4.14 设置CELLID定位授权参数应答 28
5.4.15 设置周期性上报请求 29
5.4.16 设置周期性上报应答 30
5.4.17 周期性上报位置(周期性上报亲情通终端只通过HTTP方式上报,不通过短信上报) 32
5.4.18 设置区域报警请求(适用于终端支持区域报警功能) 33
5.4.19 设置区域报警应答(适用于终端支持区域报警功能) 34
5.4.20 越界上报(终端支持区域报警功能) 35
5.4.21 亲情通终端开机时间同步请求(亲情通终端一开机与亲情通平台同步时间) 37
5.4.22 亲情通终端开机时间同步请求应答 39
5.4.23 SOS应答 S23 41
5.4.24 设置区域报警时间请求 41
注:亚终端应该支持父卡和母卡设置二个不同的区域时间段。 43
5.4.25 设置区域报警时间请求应答请求应答 43
5.4.26 设置定时上报时间请求 44
5.4.27 设置定时上报时间请求应答 45
5.4.28 设置终端心跳请求 46
5.4.29 设置终端心跳请求应答 47
5.4.30 上报心跳数据包(只支持HTTP方式上报) 49
5.4.31 登陆成功应答数据包() 49
6 编制历史 50
附录A NEMA报文格式要求 52
7 自定义协议部分 53
7.0 终端设备万能命令 53
7.0.1 组合命令 53
7.0.2 分解命令 53
7.1 终端发起轨迹上报 90 53
7.1.90.1 SMS报文 S90 53
7.1.90.2 HTTP报文 T90 54
7.2 终端发起轨迹上报回复 91 55
7.2.91.1 SMS 报文 S91 55
7.2.91.2 HTTP 报文 T91 56
7.3 终端发起主动定位请求 92 56
7.3.92.1 SMS报文 S92 56
7.3.92.2 HTTP报文 T92 57
7.4 终端发起主动定位请求回复 93 58
7.4.93.1 SMS 报文 S93 58
7.4.93.2 HTTP 报文 T93 58
7.5 设置终端短信常用语 95 59
7.5.95.1 SMS 报文 S95 59
7.6 设置终端短信常用语回复 96 60
7.6.96.1 SMS报文 S96 60
7.6.96.2 HTTP 报文 T96 60
7.7 设置终端电话本请求 97 61
7.7.97.1 SMS 报文 S97 61
7.8 设置终端电话本请求回复 98 62
7.8.98.1 SMS 报文 S98 62
7.8.98.2 HTTP 报文 T98 63
7.9 SOS 先短信后电话通知 94 63
7.9.94.1 SMS 报文 S94 63
7.9.94.2 HTTP 报文 T94 64
8.0 设置终端定时提示音 80 65
8.0.1 SMS 报文 S80 65
8.1 设置终端定时提示音回复 81 66
8.1.1 SMS报文 S81 66
8.1.2 HTTP 报文 T81 67
8.2 设置有效的短信接入号82 67
8.2.1 SMS 报文 S82 67
8.3设置有效的短信接入号回复 83 69
8.3.1 SMS报文 S83 69
8.3.2 HTTP 报文 T83 70
8.4终端菜单开关有效短信接入号请求84 71
8.4.1 SMS报文 S84 71
8.4.2 HTTP 报文 T84 71
8.5终端发起主动定位按键请求85 72
8.5.1 SMS报文 S85 72
8.5.2 HTTP 报文 T85 73
8.6 终端开始定时定位请求86 74
8.6.1 SMS报文 S86 74
8.6.2 HTTP 报文 T86 74
前 言
本协议定义了亲情通业务平台与亚终端之间的相关技术要求。
本规范主要包括亲情通业务平台与亚终端之间链路的建立,保持,查询,定位信息定时上报,相关的设置指令等。本协议基于TCP/IP协议等开发。
本标准由中移号文件印发。
本标准由中国移动通信集团公司技术部提出并归口。
本规范由规范归口部门负责解释。
本标准起草单位:中国移动通信有限公司研究院
本标准主要起草人:
1 范围
本规范规定亲情通业务平台与具有定位功能的亚终端之间的接口协议,为应用层协议,基于此接口完成亲情通业务的各种请求交互并获得位置信息。
开通亲情通业务的中国移动各省公司和亲情通业务平台提供商、终端提供商在向中国移动提供亲情通业务时应遵循本规范。
2 规范性引用文件
下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准,然而,鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件,其最新版本适用于本标准。
[1]
《中国移动亲情通业务规范》
中国移动通信有限公司
[2]
《中国移动亲情通业务平台测试规范》
中国移动通信有限公司
[3]
《中国移动终端测试规范》
中国移动通信有限公司
3 术语、定义和缩略语
A-GPS
Assisted Global Position System
辅助的全球定位系统
CMPP
China Mobile Peer to Peer
中国移动点对点协议
GPS
Global Positioning System
全球定位系统
GSM
Global System for Mobile Communication
全球移动通信系统
GIS
Geographic Information System
地理信息系统
GPRS
General Packet Radio Service
通用无线分组业务
HTTP
Hyper Text Transfer Protocol
超文本传输协议
ISMG
Internet Short Message Gateway
短信息网关
LCS
LoCation Service
位置服务
LSP
Location Service Platform
位置服务平台
MO
Message Originate
信息发送
MT
Message Terminated
信息接收
OS
Operation System
操作系统
POI
Point Of Interest
兴趣点
SMSC
Short Message Service Center
短信息中心
SMS
Short Message Service
短消息服务
SMPP
TCP
Transport Control Protocol
传输控制协议
TD
Terminal Device
终端设备
3.1 符号
SP
Space
空格
CRLF
“\r\n”
回车换行
3.2 语法说明
[a-z]
任意小写字母
[A-Z]
任意大写字母
[0-9]
任意数字
{min,max}
重复次数大于等于min,小于等于max
[a-z,A-Z,0-9]
任意字母及数字
+
一次或多次出现
*
零次或多次出现
?
可选
()
多个表达式合成一个整体
!
多选一
,
严格的序列,与AND相同
4 业务接口协议组成
通过无线网络实现数据的传输,亲情通业务平台与亚终端之间通过SMS和GPRS进行通信。
4.1 SMS接口
亲情通业务平台通过CMPP协议与短信网关交互,亲情通终端通过SMPP协议与SMSC交互,并通过ISMG与亲情通业务平台交互。
亲情通业务平台和终端之间的通信使用7bit编码。
4.2 HTTP接口
亲情通业务平台与亲情通终端通过HTTP承载的GPRS、Edge等数据链路通信方式进行交互,若HTTP通信方式失败,使用短信方式进行通信。
支持HTTP1.1版本。
5 接口通信协议
5.1 数据类型定义
类型
意义
CHAR
单个ASCII 码字符(7bit)
注意:多字节整数类型的字节序:高位在前低位在后。
5.2 报文结构定义
5.2.1 SMS报文定义(发起、应答)
报文格式
起始标识符
交易流水号
分隔符
报文类型
分隔符
短信序号
分隔符
报文体
结束标识符
报文字段说明
字段
类型
长度
描述
起始标识符
STRING
1
与结束标识符号一起定义了单个报文的完整性。采用常量字符左括号“(”表示。
交易流水号
STRING
18
时间格式+4位循环数
时间格式: yyyyMMddHHmmss
4位循环数范围0..9999,从0开始,递增赋值,步长为1,增加到9999后,再从0开始
分隔符
STRING
1
分割符号采用常量字符逗号 “,”
报文类型
STRING
3
标识本报文的含义
分隔符
STRING
1
分割符号采用常量字符逗号 “,”
短信序号
STRING
3
采用a@n的形式,n为本次请求的短信总条数,a为当先短信的序号。
报文体
STRING
不定长
报文体中多个字段之间采用 “@”分割符
结束标识符
STRING
1
采用常量字符右括号“)”表示
5.2.2 HTTP报文定义
发起报文格式:
HTTP报文头
起始标识符
交易流水号
分
隔
符
报文类型
分
隔
符
报文长度
分
隔
符
报文体
结束标识符
报文字段说明
字段
类型
长度
描述
HTTP报文头
STRING
不定长
POST /gadw/terminalgate HTTP/1.1
Host: 211.137.172.18
Content-Type: multipart/related;
User Agent:XXXX
Content-Length: XX
(说明:User Agent 格式参考终端规范)
起始标识符
STRING
1
与结束标识符号一起定义了单个报文的完整性。采用常量字符左中括号“[”表示,由于存在二进制数据,判断数据报文的完整性不应该直接利用起始标识符和结束标识符来圈定,还要根据报文内容长度或者报文内容个数进行判断
交易流水号
STRING
18
时间格式+4位循环数
时间格式: yyyyMMddHHmmss
4位循环数范围0..9999,从0开始,递增赋值,步长为1,增加到9999后,再从0开始
分隔符
STRING
1
分割符号采用常量字符逗号 “,”
报文类型
STRING
3
标识本报文的含义
分隔符
STRING
1
分割符号采用常量字符逗号 “,”
报文长度
STRING
根据报文体来确定
报文内容的长度
分隔符
STRING
1
分割符号采用常量字符逗号 “,”
报文体
STRING
不定长
报文体中多个字段之间采用 “@”分割符
结束标识符
STRING
1
采用常量字符右中括号“]”表示
应答报文格式:(待补充)
5.3 协议使用说明
1) 终端向平台发起的请求,优先采用HTTP方式,失败了使用SMS方式;;
2) 平台向终端发起的请求,全部采用SMS方式发送;
3) SMS方式的报文,一条报文如果需要分条发送,分开的每条短信都用同一交易流水号;;
4) 无论什么请求,响应报文的交易流水号与对应的请求报文的流水号一致;
5.4 双方交互的协议说明
5.4.1 登录请求
项目和项目之间不需要以!来隔开
数据与数据之间要的要以!来隔开
5.4.1.1 SMS报文 S01
报文定义如下(亚终端à亲情通业务平台):
字段
类型
取值说明
起始标识符
STRING[1]
起始标识符: (
交易流水号
STRING[18]
时间格式+4位循环数(循环增加,以下相同)
时间格式: yyyyMMddHHmmss
4位循环数范围0..9999,从0开始,递增赋值,步长为1,增加到9999后,再从0开始
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文类型
STRING[3]
取值:S01
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文序号标示
STRING[3]
采用a@n的形式,n为本次请求的短信总条数,a为当先短信的序号。
当只有一条短信的时候,此标示取值为1@1。
n<10。
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文体
STRING[0-128]
报文体格式:
亲情通子卡号码@终端普通键值数量@键值序号@是否有SOS键@是否为GPS终端@是否具备区域报警@是否具备设置呼入号码功能
字段说明:
亲情通子卡号码,如:13900000000
终端普通键值数量:如4则表示终端有4个按键
键值序号:如1;2;3;4
是否有SOS键:0表示没有,1表示有
是否为GPS终端:1表示是GPS终端
0表示不是GPS终端
是否具备区域报警:1表示具备区域报警功能
2表示不具备区域报警功能
是否具备设置呼入号码功能:1表示具备
2表示不具备
结束标识符
STRING[1]
采用常量字符右括号“)”表示
示例报文为:
(200710231200001000,S01, 1@1,13900000000@4@1;2;3;4@1@1@1@1)
5.4.1.2 HTTP报文 T01
报文定义如下(亚终端à亲情通业务平台):
字段
类型
取值说明
起始标识符
STRING[1]
起始标识符: [
交易流水号
STRING[18]
时间格式+4位循环数
时间格式: yyyyMMddHHmmss
4位循环数范围0..9999,从0开始,递增赋值,步长为1,增加到9999后,再从0开始
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文类型
STRING[3]
取值:T01
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文长度
STRING[0-3]
根据报文体的长度来确定
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文体
STRING[0-128]
报文体格式:
亲情通子卡号码@终端普通键值数量@键值序号@是否有SOS键@是否为GPS终端@是否具备区域报警@是否具备设置呼入号码功能
字段说明:
亲情通子卡号码,如:13900000000
终端普通键值数量:如4则表示终端有4个按键
键值序号:如1;2;3;4
是否有SOS键:0表示没有,1表示有
是否为GPS终端:1表示是GPS终端
0表示不是GPS终端
是否具备区域报警:1表示具备区域报警功能
2表示不具备区域报警功能
是否具备设置呼入号码功能:1表示具备
2表示不具备
结束标识符
STRING[1]
结束标识符: ]
示例报文为:
[200710231200001000,T01,29,13900000000@4@1;2;3;4@1@1@1@1]
5.4.2 登录应答
(平台判断亲情通终端是否支持区域报警功能,若亲情通终端支持登录应答中不下发报警区域,若亲情通终端不支持,登录应答中下发报警区域)
5.4.2.1 SMS报文 S02
报文定义如下(亲情通业务平台à亚终端):字段
类型
取值说明
起始标识符
STRING[1]
起始标识符: (
交易流水号
STRING[18]
同请求报文流水号
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文类型
STRING[3]
取值:S02
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文序号标示
STRING[3]
采用a@n的形式,n为本次请求的短信总条数,a为当先短信的序号。
当只有一条短信的时候,此标示取值为1@1。
n<10。
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文体
STRING[0-512]
应答消息体格式:
应答状态@终端普通键值=设置的拨打号码@CELL=设置的号码@父卡号码=定位开始时间-定位结束时间-上报频度-采样频度@母卡号码=定位开始时间-定位结束时间-上报频度-采样频度@父卡报警区域@母卡报警区域此处在下一版中加入用户设置的时间段
@区域报警位置上报时间间隔@父卡号码=父卡定时上报时间@母卡号码=母卡定时上报时间
字段说明如下:
应答状态:0:正确
1:报文错误
2:代表非法用户;
终端普通键值=设置的拨打号码:该字段支持多值的情况,多值之间用“!”符号分开,如:1=13900000001!2=13900000002!3=13900000003!4=13900000004!
其中1=13900000001表示终端1号按键对应的号码为13900000001
CELL=13900000002表示触动SOS按键打电话功能时,给13900000002该用户拨打电话;
父卡号码=定位开始时间-定位结束时间-上报频率-定位频度:该字段表示父卡号码设置的相关定时定位参数;如:13900000001=09:00-11:00-120-10缺少定位精度
!13900000001=18:00-19:00-120-10
若无轨迹设置,格式这为:
13900000001=
表示父卡号码为13900000001,定位时段为09:00到11:00,每10秒钟采集一次位置,每120秒上报一次;其中“定位开始时间-定位结束时间-上报频率-定位频度”这个可为多值,目前最多支持2个时间段;
母卡号码=定位开始时间-定位结束时间-上报频率-定位频度:见上
父卡报警区域:格式为:父卡号码=形状-元素个数-元素值1-元素值2-...-元素值n-时间范围
取值如:Round(注:代表圆)-2-(136.123456,39.123456)(注:圆心经纬度)-(1000)(注:半径,单位:米)
目前暂只支持圆形区域。,可拥有多个报警区域,以”!”分割及结尾
时间范围:可以有一或两个时间段,以!分割以及结尾,如:10:00-11:00!15:00-16:00!
母卡报警区域:格式为母卡号码=形状-元素个数-元素值1-元素值2-...-元素值n-时间范围
具体说明见上。
区域报警位置上报时间间隔: 单位(分钟)
父卡定时上报时间:可以有最多5个时间,以!分割以及结尾,如:10:00!15:00-16:00!,若没有,则为空
母卡定时上报时间:格式同父卡定时上报时间
结束标识符
STRING[1]
采用常量字符右括号“)”表示
示例报文为:示例报文需要修改
(200710231200001000,S02,1@3, 0@1=13900000001!2=13900000002!3=13900000003!4=13900000004!@ CELL=13900000002!)
(200710231200001000,S02,2@3, @13900000001=09:00-11:00-120-10!@13900000002=17:00-18:00-120-10修改
!@13900000001= Round-2-(136.123456, )
(200710231200001000,S02,3@3, 39.123456)-(1000)-( 10:00-11:00!15:00-16:00!)!@ 13900000002= Round-2-(136.123456,39.123456)-(1000)-( 10:00-11:00!15:00-16:00!)!@10@13900000001=12:00!@ 13900000002=10:00!)
5.4.2.2 HTTP报文 T02修改内容同S02
报文定义如下(亲情通业务平台à亚终端):
字段
类型
取值说明
起始标识符
STRING[1]
起始标识符: [
交易流水号
STRING[18]
同登录报文流水号
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文类型
STRING[3]
取值:T02
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文长度
STRING[0-3]
根据报文体的长度来确定
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文体
STRING[0-512]
应答消息体格式:
应答状态@终端普通键值=设置的拨打号码@SOS类型=设置的号码@父卡号码=定位开始时间-定位结束时间-上报频度-定位频度@母卡号码=定位开始时间-定位结束时间-上报频度-定位频度@父卡报警区域@母卡报警区域此处在下一版中加入用户设置的时间段
@区域报警位置上报时间间隔@父卡号码=父卡定时上报时间@母卡号码=母卡定时上报时间
字段说明如下:
应答状态:0:正确
1:报文错误
2:代表非法用户;
终端普通键值=设置的拨打号码:该字段支持多值的情况,多值之间用“!”符号分开,如:1=13900000001!2=13900000002!3=13900000003!4=13900000004!
其中1=13900000001表示终端1号按键对应的号码为13900000001
SOS类型=设置的号码:该字段目前只支持一种情况: CELL=13900000002表示触动SOS按键打电话功能时,给13900000002该用户拨打电话;
父卡号码=定位开始时间-定位结束时间-上报频率-定位频度:该字段表示父卡号码设置的相关定时定位参数;如:13900000001=09:00-11:00-120-10表示父卡号码为13900000001,定位时段为09:00到11:00,每10秒钟采集一次位置,每120秒上报一次;其中“定位开始时间-定位结束时间-上报频率-定位频度”这个可为多值,目前最多支持2个时间段;
13900000001=09:00-11:00-120-10缺少定位精度
!13900000001=18:00-19:00-120-10
记住了:如果用户未设置活动路径,则为
13900000001=@13900000001=@ 父母卡一定传。否则08包的SS不上报。
母卡号码=定位开始时间-定位结束时间-上报频率-定位频度:见上
父卡报警区域:格式为:父卡号码=形状-元素个数-元素值1-元素值2-...-元素值n-时间范围
取值如:Round(注:代表圆)-2-(136.123456,39.123456)(注:圆心经纬度)-(1000)(注:半径,单位:米)
目前暂只支持圆形区域。,可拥有多个报警区域,以”!”分割及结尾
时间范围:可以有一或两个时间段,以!分割以及结尾,如:10:00-11:00!15:00-16:00!
母卡报警区域:格式为母卡号码=形状-元素个数-元素值1-元素值2-...-元素值n-时间范围
具体说明见上。
区域报警位置上报时间间隔: 单位(分钟)
父卡定时上报时间:可以有最多5个时间,以!分割以及结尾,如:10:00!15:00-16:00!,若没有,则为空
母卡定时上报时间:格式同父卡定时上报时间
结束标识符
STRING[1]
结束标识符: ]
示例应答报文为:
[200710231200001000,T02,376,0@1=13900000001!2=13900000002!3=13900000003!4=13900000004!@SMS=13900000001!CELL=13900000002@13900000001=09:00-11:00-120-10!@13900000002=17:00-18:00-120-10!@13900000001=Round-2-(136.123456,39.123456)-(1000)-( 10:00-11:00!15:00-16:00!)!Round-2-(166.654321,80.654321)-(500)-(13:00-14:00!)!@ 13900000002= Round-2-(136.123456,39.123456)-(1000)-( 10:00-11:00!15:00-16:00)! @10@13900000001=12:00!@ 13900000002=10:00!]
注:只有当应答状态为0时,应答消息体为完整格式,否则返回应答状态即可;如果应答状态为2时,终端则不再发起任何GPRS连接和短信。
当应答消息体为完整格式时,需求亚终端解析应答消息体,然后刷新一下该亚终端中的相关数据。
5.4.3 设置呼入号码请求
5.4.3.1 SMS报文 S03
报文定义如下(亲情通业务平台à亚终端):
字段
类型
取值说明
起始标识符
STRING[1]
起始标识符: (
交易流水号
STRING[18]
时间格式+4位循环数
时间格式: yyyyMMddHHmmss
4位循环数范围0..9999,从0开始,递增赋值,步长为1,增加到9999后,再从0开始
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文类型
STRING[3]
取值:S03
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文序号标示
STRING[3]
采用a@n的形式,n为本次请求的短信总条数,a为当先短信的序号。
当只有一条短信的时候,此标示取值为1@1。
n<10。
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文体
STRING[0-128]
报文内容格式:
状态标记@呼入号码列表与对应时间段
字段说明如下:
状态标记:1表示新增 2表示修改 3表示删除
目前新增和修改状态的处理是一样的,都是按照报文更新信息。
呼入号码列表与对应时间段:该字段取值可为多个;最多支持15个呼入号码;取值如:
13900000001-09:00-10:00!13900000002-11:00-12:00!
13900000003-13:00-14:00!13900000004-15:00-16:00
有需用“!”隔开的多个值时,最后一位加上“!”
结束标识符
STRING[1]
采用常量字符右括号“)”表示
示例报文为:
(200710231200001000,S03,1@1,1@13900000001-09:00-10:00!13900000002-11:00-12:00!
13900000003-13:00-14:00!13900000004-15:00-16:00!)
5.4.4 设置呼入号码应答
5.4.4.1 SMS报文 S04
报文定义如下(亚终端à亲情通业务平台):
字段
类型
取值说明
起始标识符
STRING[1]
起始标识符: (
交易流水号
STRING[18]
同请求报文流水号
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文类型
STRING[3]
取值:S04
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文序号标示
STRING[3]
采用a@n的形式,n为本次请求的短信总条数,a为当先短信的序号。
当只有一条短信的时候,此标示取值为1@1。
n<10。
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文体
STRING[0-128]
应答状态:0:新增或修改或删除设置呼入号码正确
1:新增或修改或删除设置呼入号码错误
结束标识符
STRING[1]
采用常量字符右括号“)”表示
示例报文为:
(200710231200001000,S04,1@1,0)
5.4.4.2 HTTP报文 T04
报文定义如下(亚终端à亲情通业务平台):
字段
类型
取值说明
起始标识符
STRING[1]
起始标识符: [
交易流水号
STRING[18]
同请求报文流水号
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文类型
STRING[3]
取值:T04
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文长度
STRING[0-3]
根据报文体的长度来确定
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文体
STRING[0-128]
应答状态:
0:新增或修改或删除设置呼入号码正确
1:新增或修改或删除设置呼入号码错误
结束标识符
STRING[1]
结束标识符: ]
示例报文为:
[200710231200001000,T04,1,0]
5.4.5 缺电报警/关机报警请求
5.4.5.1 SMS报文 S05
报文定义如下(亚终端à亲情通业务平台):
字段
类型
取值说明
起始标识符
STRING[1]
起始标识符: (
交易流水号
STRING[18]
时间格式+4位循环数
时间格式: yyyyMMddHHmmss
4位循环数范围0..9999,从0开始,递增赋值,步长为1,增加到9999后,再从0开始
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文类型
STRING[3]
取值:S05
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文序号标示
STRING[3]
采用a@n的形式,n为本次请求的短信总条数,a为当先短信的序号。
当只有一条短信的时候,此标示取值为1@1。
n<10。
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文体
STRING[0-128]
类型@亲情通子卡号码@附加说明
类型:缺电报警为1 关机报警为2
缸电报警取值:1@13900000000@10%
意思是最低报警电量低于10%时亚终端将会发送报告给亲情通业务平台,该阀值由终端自行决定。
关机报警取值:2@13900000000@
结束标识符
STRING[1]
采用常量字符右括号“)”表示
示例报文为:
(200710231200001000,S05,1@1, 1@13900000000@10%)
5.4.5.2 HTTP报文 T05(缺电报警)
报文定义如下(亚终端à亲情通业务平台):
字段
类型
取值说明
起始标识符
STRING[1]
起始标识符: [
交易流水号
STRING[18]
时间格式+4位循环数
时间格式: yyyyMMddHHmmss
4位循环数范围0..9999,从0开始,递增赋值,步长为1,增加到9999后,再从0开始
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文类型
STRING[3]
取值:T05
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文长度
STRING[0-3]
根据报文体的长度来确定
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文体
STRING[0-128]
类型@亲情通子卡号码@附加说明
类型:缺电报警为1 关机报警为2
缸电报警取值:1@13900000000@10%
意思是最低报警电量低于10%时亚终端将会发送报告给亲情通业务平台,该阀值由终端自行决定。
关机报警取值:2@13900000000@
结束标识符
STRING[1]
结束标识符: ]
示例报文为:
[200710231200001000,T05,17, 1@13900000000@10%]
5.4.6 缺电报警/关机报警应答 S06
5.4.6.1 SMS报文 S06(缺电报警)
报文定义如下(亲情通业务平台à亚终端):
字段
类型
取值说明
起始标识符
STRING[1]
起始标识符: (
交易流水号
STRING[18]
同请求报文流水号
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文类型
STRING[3]
取值:S06
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文序号标示
STRING[3]
采用a@n的形式,n为本次请求的短信总条数,a为当先短信的序号。
当只有一条短信的时候,此标示取值为1@1。
n<10。
分隔符
STRING[1]
分割符号采用常量字符逗号 “,”
报文体
STRING[0-128]
应答状态:0:正确
1:非亲情通子卡号码
2:其他错误
结束标识符
STRING[1]
采用常量字符右括号“)”表示
示例报文为:
(200710231200001000,S06,1@1, 0)
5.4.6.2 HTTP报文 T06(缺电报警)
报文定义如下(亲情通业务平台à亚终端):
字段
类型
展开阅读全文