《手机定位用户使用手册V5.0.docVIP

短信及定位业务XML系统用户使用手册 版本号〈5.0〉 发布时间〈2009-8-5〉 编写人〈范长发〉 修订纪录 修改人 修改原因 修改批准人 修改完成日期 版本号 周涛 定稿 2006-1-25 2.0 范长发 增加运单定位 2008-6-3 3.0 范长发 增加获取车辆资料 2009-3-3 4.0 范长发 增加精确定位 2009-11-5 5.0 V5.0 调整点： 增加精确定位的功能接口； 调整短信、城市定位的接口，在上下行内容中增加“external_note”元素，由接口用户自行定义； 概要 为管车宝用户提供短信及定位功能，包括发送下行短信、城市定位、精确定位以及获取车辆资料等功能。 本文档描述上述功能接口的相关信息，包括调用方式、通讯报文、错误处理及注意事项等。 术语定义 名词 含义 GCBER 管车宝用户 YHJX 怡和佳讯公司 MO Mobile original（手机上行） MT Mobile terminal（下行到手机） LBS 定位系统 功能接口定义 包括发送下行短信、城市定位、运单定位以及获取车辆资料四个功能。 接口通过TCP/IP协议传输报文，报文使用xml格式，双方系统需要通过用户名/密码、IP地址等鉴权方式校验对方身份。 接口使用长连接方式，在建立连接以后，GCBER通过发送心跳报文来维持连接不中断。 请求连接报文 功能描述 GCBER发起，向YHJX的接口程序发送请求连接报文，用于建立连接，YHJX的接口程序在对GCBER进行验证后，如果验证通过，向GCBER发送连接已经建立的通知报文，如果验证不通过，向GCBER发送鉴权失败的通知报文并关闭连接。 接口描述 提交方式：GCBER向接口发送请求报文，提交到对应的接口地址。 接口地址： 31 端口：5100 报文定义 请求报文定义 ?xml version=1.0 encoding=GB2312? yhjx_init request typeopen_session/type client id******/id pwd******/pwd /client /request /yhjx_init 返回报文 ?xml version=1.0 encoding=GB2312? yhjx_result response type open_session /type result result_id0008/result_id result_info连接建立成功/result_info datetime2005-06-23 12:00:00/datetime /result /response /yhjx_result 心跳报文 功能描述 GCBER发起，向YHJX的接口程序发送心跳报文，用于保持连接不中断。心跳发送间隔时间5分钟。 接口描述 提交方式：GCBER向接口发送请求报文，提交到对应的接口地址。 接口地址： 31 端口：5100 报文定义 请求报文定义 ?xml version=1.0 encoding=GB2312? yhjx_init request typeheart_beat/type /request /yhjx_init 2.返回报文定义 ?xml version=1.0 encoding=GB2312? yhjx_result response typeheart_beat/type /response /yhjx_result 发送短信 功能概述 GCBER发起，向YHJX的接口程序发送请求报文，YHJX的接口程序回复发送结果报文。 接口描述 提交方式：GCBER向接口发送请求报文，提交到对应的接口地址。 接口地址： 31 端口：5100 报文定义 1.请求报文示例 ?xml version=1.0 encoding=GB2312? yhjx_init request typesms_submit/type info msid13*********/msid content短信内容/content datetime2005-06-23 12:00:00/datetime external_note*****/external_note /info /request /yhjx_init 2.结果报文示例 ?xml version=1.0 encoding=GB2312? yhjx_result