爱贝通公话软件接口规范.doc

校迅通接口规范 （V1.0） 修订记录 日期 版本 说明 作者 注： 目录 1 介绍 4 1.1 目的 4 1.2 适用范围 4 1.3 缩略语 4 2 接口协议概述 5 2.1 GPRS协议 5 2.2 接口分类 5 3 数据类型和格式定义 6 3.1 数据类型定义 6 3.2 PDU格式概述 6 3.3 UASP PDU布局 7 4 公话PDU接口定义 8 4.1 公话认证 [取值:10] 8 4.2 “STDT_CARD_LOGIN”学生卡登录[取值:01] 8 4.3 “STDT_READ_MSG”学生卡读取留言[取值:02] 9 4.4 “CALL_BILLING”通话话单 [取值:03] 9 4.5 “STDT_SIGN_RECS”学生签到记录[取值:04] 9 4.6 “CONNECT_STATUS”网络连接状态查询[取值:05] 10 4.7 “STDT_NO_LOGIN”学号登录操作[取值:07] 10 5 公话管理接口定义 11 5.1 “UPDATE_NOTICE”程序更新通知[取值:80] 11 5.2 “UPDATE_PROGRAM”程序更新[取值:81] 11 5.3 “ABT_STATUS”公话状态查询[取值:82] 11 5.4 “GET_ADMIN_PWD”读取管理员密码[取值:92] 12 5.5 “SET_ADMIN_PWD”设置管理员密码[取值:93] 12 5.6 “EDIT_ABT_SET”修改终端设置[取值:94] 12 5.7 “SET_ABT_RESET”设置终端重启[取值:95] 13 5.8 亲情号码更新同步[取值:83] 13 5.9 亲情号码更新数据发送[取值:84] 13 5.10 亲情号码删除（全部删除）[取值:85] 14 5.11 亲情号码删除卡信息（删除某个卡信息）[取值:86] 14 5.12 发送短消息[取值:06] 14 5.13 更新短消息类型[取值:89] 14 5.14 更新短消息[取值:90] 15 5.15 更新短消息版本[取值:91] 15 5.16 巡检注册与修改手机号[取值:62] 15 5.17 巡检登录[取值:63] 16 5.18 教师拨打电话权限验证[取值:74] 16 6 参数取值定义 17 介绍 目的 中国移动校讯通业务可允许用户在学校使用公话享受移动服务。校讯通公话接口协议定义了校讯通业务中校园公话与公话服务器之间的接口协议及公话与读卡器的通讯协议。 校讯通公话接口采用GPRS通讯方式。 适用范围 本文定义了校讯通公话接口协议，规定了请求应答的会话方式、报文格式和语法，适用于外部实体开发商利用校讯通公话接口访问校讯通公话服务时参考。 缩略语 SC (Service Center)：数据采集中心 ABT (Child-caring System Teminal)：校讯通公话终端 SRFC (Student RF Card)：学生专用的RF卡 接口协议概述 GPRS协议 校讯通公话接口采用GPRS协议与移动SC进行数据通讯。本质上是基于TCP/IP协议之上的应用层协议，以TCP协议进行数据传输，采用请求/应答的同步通讯模型实现。 SC使用公网地址，在某个端口侦听校讯通公话连接，可以使用认证方式建立连接。 接口分类 公话接口分为以下几类： ·普通公话接口 提供普通公话服务。如IC/ID卡登录，读取留言，通话话单上传等。 ·校园数据库接口 校园学校签到/刷卡设备使用。 ·公话管理接口 提供公话设备的系统管理接口。包括更新通知，程序更新，公话状态查询等。 终端开机基本流程 ·校讯通开机上电后，会自动用GPRS登陆校讯通平台，登陆平台后终端首先会发送“公话认证 [取值:10]”消息给服务器，服务器回应“公话认证 [取值:10]”消息并自动往终端下发“公话状态查询[取值:82]”消息给终端，终端回应“公话状态查询[取值:82]”给服务器完成双方握手。 ·如果双方握手不成功，终端会自动断开与服务器的连接并自动重连。 ·完成以上动作后校讯通就可正常工作，终端会在空闲时每3分钟主动发送心跳包（“网络连接状态查询[取值:05]”消息）给服务器，服务器需回应心跳包。服务器依靠心跳包判断终端是否在线。 数据类型和格式定义 数据类型定义 类型 说明 String 字节串。如无特别说明则左齐右补空格（ASCII码32），字节串的最后一字符不可为空格。 VST 变化的字符串。字符串的最大长度由协议给出。字符串的具体长度根据PDU包头的length字段给出。因此VST必须放在每个包的最后一个。 Integer 定长String, 它由一系列的10进制字符组成（‘0’---‘9’），右齐左补