《《精编》中国移动亲情通业务接口规范》由会员分享,可在线阅读,更多相关《《精编》中国移动亲情通业务接口规范(81页珍藏版)》请在金锄头文库上搜索。
1、中国移动通信有限公司 发布中国移动通信企业标准QB-亲情通业务接口规范Family Locating Service Interface Specification 版本号:V1.0.0-发布-实施目 录1范围12规范性引用文件13术语、定义和缩略语13.1符号23.2语法说明24业务接口协议组成34.1SMS接口34.2HTTP接口35接口通信协议35.1数据类型定义35.2报文结构定义35.2.1SMS报文定义(发起、应答)35.2.2HTTP报文定义45.3协议使用说明65.4双方交互的协议说明65.4.1登录请求65.4.2登录应答95.4.3设置呼入号码请求145.4.4设置呼入号码
2、应答155.4.5缺电报警/关机报警请求175.4.6缺电报警/关机报警应答 S06185.4.7查询请求205.4.8查询应答215.4.9设置Http通信URL(群发)235.4.10设置HTTP通信URL应答245.4.11设置普通按键/SOS按键请求245.4.12设置普通按键/SOS按键应答265.4.13设置CELLID定位授权参数请求275.4.14设置CELLID定位授权参数应答285.4.15设置周期性上报请求295.4.16设置周期性上报应答305.4.17周期性上报位置(周期性上报亲情通终端只通过HTTP方式上报,不通过短信上报)325.4.18设置区域报警请求(适用于终
3、端支持区域报警功能)335.4.19设置区域报警应答(适用于终端支持区域报警功能)345.4.20越界上报(终端支持区域报警功能)355.4.21亲情通终端开机时间同步请求(亲情通终端一开机与亲情通平台同步时间)375.4.22亲情通终端开机时间同步请求应答395.4.23SOS应答 S23415.4.24设置区域报警时间请求41注:亚终端应该支持父卡和母卡设置二个不同的区域时间段。435.4.25设置区域报警时间请求应答请求应答435.4.26设置定时上报时间请求445.4.27设置定时上报时间请求应答455.4.28设置终端心跳请求465.4.29设置终端心跳请求应答475.4.30上报心
4、跳数据包(只支持HTTP方式上报)495.4.31登陆成功应答数据包()496编制历史50附录A NEMA报文格式要求527 自定义协议部分537.0 终端设备万能命令537.0.1 组合命令537.0.2 分解命令537.1 终端发起轨迹上报 90537.1.90.1 SMS报文 S90537.1.90.2 HTTP报文 T90547.2 终端发起轨迹上报回复 91557.2.91.1 SMS 报文 S91557.2.91.2 HTTP 报文 T91567.3 终端发起主动定位请求 92567.3.92.1 SMS报文 S92567.3.92.2 HTTP报文 T92577.4 终端发起主动
5、定位请求回复 93587.4.93.1 SMS 报文 S93587.4.93.2 HTTP 报文 T93587.5 设置终端短信常用语 95597.5.95.1 SMS 报文 S95597.6 设置终端短信常用语回复 96607.6.96.1 SMS报文 S96607.6.96.2 HTTP 报文 T96607.7 设置终端电话本请求 97617.7.97.1 SMS 报文 S97617.8 设置终端电话本请求回复 98627.8.98.1 SMS 报文 S98627.8.98.2 HTTP 报文 T98637.9 SOS 先短信后电话通知 94637.9.94.1 SMS 报文 S94637
6、.9.94.2 HTTP 报文 T94648.0 设置终端定时提示音 80658.0.1 SMS 报文 S80658.1 设置终端定时提示音回复 81668.1.1 SMS报文 S81668.1.2 HTTP 报文 T81678.2 设置有效的短信接入号82678.2.1 SMS 报文 S82678.3设置有效的短信接入号回复 83698.3.1 SMS报文 S83698.3.2 HTTP 报文 T83708.4终端菜单开关有效短信接入号请求84718.4.1 SMS报文 S84718.4.2 HTTP 报文 T84718.5终端发起主动定位按键请求85728.5.1 SMS报文 S85728
7、.5.2 HTTP 报文 T85738.6 终端开始定时定位请求86748.6.1 SMS报文 S86748.6.2 HTTP 报文 T8674前 言本协议定义了亲情通业务平台与亚终端之间的相关技术要求。本规范主要包括亲情通业务平台与亚终端之间链路的建立,保持,查询,定位信息定时上报,相关的设置指令等。本协议基于TCP/IP协议等开发。本标准由中移号文件印发。本标准由中国移动通信集团公司技术部提出并归口。本规范由规范归口部门负责解释。本标准起草单位:中国移动通信有限公司研究院本标准主要起草人:1 范围本规范规定亲情通业务平台与具有定位功能的亚终端之间的接口协议,为应用层协议,基于此接口完成亲情
8、通业务的各种请求交互并获得位置信息。开通亲情通业务的中国移动各省公司和亲情通业务平台提供商、终端提供商在向中国移动提供亲情通业务时应遵循本规范。2 规范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准,然而,鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件,其最新版本适用于本标准。1中国移动亲情通业务规范中国移动通信有限公司2中国移动亲情通业务平台测试规范中国移动通信有限公司3中国移动终端测试规范中国移动通信有限公司3 术语、定义和缩略语A-GPSAssiste
9、d Global Position System辅助的全球定位系统CMPPChina Mobile Peer to Peer中国移动点对点协议GPSGlobal Positioning System全球定位系统GSMGlobal System for Mobile Communication全球移动通信系统GISGeographic Information System地理信息系统GPRSGeneral Packet Radio Service通用无线分组业务HTTPHyper Text Transfer Protocol超文本传输协议ISMGInternet Short Message Ga
10、teway短信息网关LCSLoCation Service位置服务LSPLocation Service Platform位置服务平台MOMessage Originate信息发送MTMessage Terminated信息接收OSOperation System操作系统POIPoint Of Interest兴趣点SMSCShort Message Service Center短信息中心SMSShort Message Service短消息服务SMPPTCPTransport Control Protocol传输控制协议TDTerminal Device 终端设备3.1 符号SPSpace空
11、格CRLF“rn”回车换行3.2 语法说明a-z任意小写字母A-Z任意大写字母0-9任意数字min,max重复次数大于等于min,小于等于maxa-z,A-Z,0-9任意字母及数字+一次或多次出现*零次或多次出现?可选()多个表达式合成一个整体!多选一,严格的序列,与AND相同4 业务接口协议组成通过无线网络实现数据的传输,亲情通业务平台与亚终端之间通过SMS和GPRS进行通信。4.1 SMS接口亲情通业务平台通过CMPP协议与短信网关交互,亲情通终端通过SMPP协议与SMSC交互,并通过ISMG与亲情通业务平台交互。亲情通业务平台和终端之间的通信使用7bit编码。4.2 HTTP接口亲情通业
12、务平台与亲情通终端通过HTTP承载的GPRS、Edge等数据链路通信方式进行交互,若HTTP通信方式失败,使用短信方式进行通信。支持HTTP1.1版本。5 接口通信协议5.1 数据类型定义类型 意义CHAR单个ASCII 码字符(7bit)注意:多字节整数类型的字节序:高位在前低位在后。5.2 报文结构定义5.2.1 SMS报文定义(发起、应答)报文格式起始标识符交易流水号分隔符报文类型分隔符短信序号分隔符报文体结束标识符报文字段说明字段类型长度描述起始标识符STRING1与结束标识符号一起定义了单个报文的完整性。采用常量字符左括号“(”表示。交易流水号STRING18时间格式+4位循环数时间
13、格式: yyyyMMddHHmmss4位循环数范围0.9999,从0开始,递增赋值,步长为1,增加到9999后,再从0开始分隔符STRING1分割符号采用常量字符逗号 “,”报文类型STRING3标识本报文的含义分隔符STRING1分割符号采用常量字符逗号 “,”短信序号STRING3采用an的形式,n为本次请求的短信总条数,a为当先短信的序号。报文体STRING不定长报文体中多个字段之间采用 “”分割符结束标识符STRING1采用常量字符右括号“)”表示5.2.2 HTTP报文定义发起报文格式:HTTP报文头起始标识符交易流水号分隔符报文类型分隔符报文长度分隔符报文体结束标识符报文字段说明字段类型长度描述HTTP报文头STRING不定长POST /gadw/terminalgate HTTP/1.1Host: 211.137.172.18Content-Type: multipart/related;User Agent:XXXXContent-Length: XX(说明:User Agent 格式参考终端规范)起始标识符STRING1