无线上网终端软件通讯协议11.docVIP

无线上网终端软件通讯协议 V1.0 For Http方式 拟制： 程鹏飞 日期： 2010/9/7 审核： 日期： 概述 目的 本《通讯协议》，以下简称本协议，是为说明client和server之间的通讯协议，包括协议的字段定义、说明、上下行示例等。通过本协议，希望开发人员可以了解client和server之间的通讯方法。 术语 终端：这里主要指无线上网笔记本 Client：即运行于终端上的客户端。 Server：服务Server。 说明 本协议是建立在Http和WAP2.0的基础之上的，其基本规则与Http规则相同，涉及到Http部分的内容如有不明之处请参见Http协议，本文档只描述其扩展部分。 Client只能和Http进行问答式操作，如获取待办事宜列表等。 该版本默认使用UTF-8编码方式。 协议实例为参考，实际以协议描述为准 协议参数 参数说明 本协议适用Http通讯标准（兼容socket协议和WAP2.0协议），并在其上作业务性扩展。当前版本要求Http采用post方式的request/response。 request/response描述：request以POST方式发送XML，关键字是“XML”；response处理业务拼装XML，返回Client信息为xml长度+xml。编码格式为：UTF-8。 参数传递基本形式以标准XML，例如： protocol head useridguolei09319973493/userid userpwdUK73jkOI9432*dlO3PK/userpwd ecp0/ecp edtion1.0/ edtion cversion1.0/ cversion cmac**-**-**/ cmac syswin7/sys /head main cmdUSERAUTH/cmd /main result lists type=001 item business041/business name待办事宜/name num4/num /item item business022/business name收件箱/name num11/num /item /lists /result /protocol 规则描述如下： 参数关系和结构用XML描述； 参数值写入XML,如果该值为空，必须以“”写入，不得为空； 参数数值使用十进制； 参数中的特殊字符要求转义，比如将’转换为‘； 本协议中所用到的参数有两类： 系统/协议相关基本参数。 具体命令相关参数。 规定： 基本参数放在head部分，命令参数放在后main。 2、返回结果放在result部分。 参数名用英文字母表示，不携带中文。参数说明表格对应项说明： 代码：参数代码； 必选：参数在协议体中是否必选。如参数可以提供，建议使用。如有特殊说明，根据具体情况处理； 描述：指令的功能或含义描述 取值：参数取值说明。如无特殊说明，可根据情况自己定义字符串；如果是以“，”隔开，可选择一项或者按照常规进行扩展；如果是以“/”隔开，只能选择其中一项。括号内为注释 基本参数 请求包： 所属 代码 必选 描述 取值 HEAD HEAD Y 头模块 EDTION Y 协议版本 参考《j2meRssReader协议版本定义说明 CVERSION Y 客户端版本 标识各种客户端版本 ECP N 密码加密等级 0,1,2,,,默认为0 (不加密) UID Y 用户ID USERPWD Y 用户密码 6-15位，目前一般为6位 CMAC Y 终端MAC地址 计算机MAC地址 SYS Y 客户端系统 Win7、WinXP、Vista等 LONG N 经度 LATI N 维度 MAIN MAIN Y 命令模块 参见第3章 serId Y 序列号，事务唯一标示 8位数字（客户端生成） 应答包： 所属 代码 必选 描述 取值 HEAD HEAD Y 头模块 EDTION Y 协议版本 参考《j2meRssReader协议版本定义说明 CVERSION Y 客户端版本 标识各种客户端版本 ECP N 密码加密等级 0,1,2,,,默认为0 (不加密) UID Y 用户ID USERPWD Y 用户密码 6-15位，目前一般为6位 CMAC Y 终端MAC地址 计算机MAC地址 SYS Y 客户端开发系统 mobile,java MAIN serId Y 序列号，事务唯一标示 8位数字（客户端生成） RES