手机定位用户使用手册V5.0.docx

短信及定位业务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调整点： 1、 增加精确定位的功能接口; 2、 调整短信、城市定位的接口，在上下行内容中增加“ external_note‘元素，由 接口用户自行定义； 1.1概要 为管车宝用户提供短信及定位功能，包括发送下行短信、城市定位、精确定位以 及获取车辆资料等功能。 本文档描述上述功能接口的相关信息，包括调用方式、通讯报文、错误处理及注 意事项等。 1.2术语定义 名词 含义 GCBER 管车宝用户 YHJX 怡和佳讯公司 MO Mobile original （手机上行） MT Mobile terminal （下行到手机） LBS 定位系统 1.3功能接口定义 包括发送下行短信、城市定位、运单定位以及获取车辆资料四个功能。 接口通过TCP/IP协议传输报文，报文使用xml格式，双方系统需要通过用户名/密 码、IP地址等鉴权方式校验对方身份。 接口使用长连接方式，在建立连接以后， GCBER通过发送心跳报文来维持连接不 中断。 1.3.1请求连接报文 功能描述 GCBER发起，向YHJX的接口程序发送请求连接报文，用于建立连接， YHJX的接 口程序在对GCBER进行验证后，如果验证通过，向 GCBER发送连接已经建立的通 知报文，如果验证不通过，向 GCBER发送鉴权失败的通知报文并关闭连接。 接口描述 提交方式： GCBER向接口发送请求报文，提交到对应的接口地址。 接口地址： 31 端口： 5100 131.3 报文定义 1.请求报文定义 v?xml versio n=1.0 en codi ng=GB2312? vyhjx_i nit request typeope n_sessi on /type clie nt id******/id id ****** /id vpwd******v/pwd /clie nt /request /yhjx_i nit 2.返回报文 ?xml versio n=1.0 en codi ng=GB2312? yhjx_result resp on se type ope n_sessi on /type result result_id0008/result_id result_info连接建立成功 /result_info datetime2005-06-23 12:00:00/datetime /result /resp on se /yhjx_result 1.3.2心跳报文 功能描述 GCBER发起，向YHJX的接口程序发送心跳报文，用于保持连接不中断。心跳发送 间隔时间5分钟。 接口描述 提交方式：GCBER向接口发送请求报文，提交到对应的接口地址。 接口地址：端口：315100 接口地址： 端口： 31 5100 报文定义 请求报文定义 v?xml version=1.0 encoding=GB2312? vyhjx_i nit request typeheart_beat/type v/request /yhjx_i nit 返回报文定义 ?xml version=1.0 encoding=GB2312? yhjx_result resp on se typeheart_beat/type /resp on se /yhjx_result 1?3?3发送短信 功能概述 GCBER发起，向YHJX的接口程序发送请求报文，YHJX的接口程序回复发送结 果报文。 接口描述 提交方式：GCBER向接口发送请求报文，提交到对应的接口地址。 接口地址：31 端口： 5100 报文定义 请求报文示例 ?xml versio n=1.0 en codi ng=GB2312? yhjx_i nit request typesms_submit/type info msid13*********/msid vcontent^信内容 /content datetime2005-06-23 12:00:00/datetime vexter nal_no te*****v/exter nal_no te v/info /request /yhjx_i nit 2?结果报文示例 ?xml versio n=1.0 en codi ng=GB2312? yhjx_result resp on se typesms_submit/type