浙江移动校讯通校园IT接口规范1.4.docVIP

中国移动通信集团浙江公司 校讯通统一平台与校园IT接口规范 全通 二○一一年4月 文档变更记录 序号 变更内容说明 版本号 版本日期 执笔人 1 始建 1.0 2011-03-31 杨高岭 2 修改，增加亲情号码、所带班级的同步 1.3 2011-12-07 孙友华 3 修改消息结构方法名 1.4 2011-12-08 孙友华  目 录 1. 概述 1 1.1. 接口概述 1 1.2. 文档概述 1 1.3. 引用标准 1 2. 单点登录 1 2.1. 总体要求 1 2.2. 接口方式 2 2.3. 消息结构 2 2.3.1. 单点登录请求报文(学校-XXT) 2 2.3.2. 单点登录应答(XXT-学校) 3 3. 学校IT系统与XXT短信、数据接口 5 3.1. 总体要求 5 3.2. 接口方式 5 3.3. 消息结构 5 3.3.1. 教师资料变更请求(学校-XXT) 6 3.3.2. 教师资料变更应答(XXT-学校) 6 3.3.3. 学生资料变更请求(学校-XXT) 8 3.3.4. 学生资料变更应答(XXT-学校) 9 3.3.5. 家长资料变更请求(学校-XXT) 9 3.3.6. 家长资料变更应答(XXT-学校) 10 3.3.7. 订购关系变更请求(学校-XXT) 11 3.3.8. 订购关系变更应答(XXT-学校) 12 3.3.9. 短信下行请求(学校-XXT) 12 3.3.10. 短信下行应答(XXT-学校) 13 3.3.11. 短信上行请求(学校-XXT) 14 3.3.12. 短信上行应答(XXT-学校) 15 4. 错误码 17 5. 接口功能号 19 概述 接口概述 根据学校需求及学校信息化程度不同，本次接口协议包括单点登录及短信、数据接口两个层级的接入，两个层次的接口采用不同的协议及实现。 文档概述 本文档后续分为两部分讲述单点登录及短信、数据接口的实现方式、协议属性、流程、报文格式等。 引用标准 单点登录 单点登录适合于学校有内部IT系统，教师希望通过登录内部系统后，直接单点登录到校讯通平台，而不需要重复多次登录。学校教师、学生、订购关系等资料由代理商维护。 总体要求 资料维护：实现本接口的学校SA首先需把校讯通所需的基本资料维护录入到统一平台，资料包括教师、学生、家长、订购关系等。并由SA手工维持资料的变更。 安全设计：数据报文采用DES加密传输，由统一平台提供密钥（线下提供），报文发送端使用密钥加密，报文接收端使用密钥进行报文解密。报文认证包括ip鉴权，非学校IP地址不能登录。 接口方式 采用http+xml方式 消息结构 每个交易消息(包括请求和应答)有一个是名字（Message Name），交易消息以XML格式表达的，根据XML的定义，每个XML文件需要有特定的Root Tag（根标记），在本规范中，用消息名作为根节点，根节点下包括两个部分：Message Header(消息头)与Message Body (消息体，交易业务内容)。其中，Message Header用于存储交易请求以及应答的公共部分和消息的控制数据，而Message Body作为消息体，包含交易请求和应答的业务数据。 单点登录请求报文(学校-XXT) 学校IT系统与XXT单点登录接口请求报文各个字段解释如下表。 Message Name：LoginRequest；  序号 父元素名称 元素名称 类型 长度 取值说明 1 HEAD FunctionCode String 3 消息标志：详细见消息功能编号文档 2 HEAD TransId String 22 消息序列号：在发起方唯一标识一个交易的流水号，系统内唯一 22位唯一流水 组成方式：”IT”＋8位日期＋12位唯一数，每天从000000000001开始，如SI20060801000000000001 3 HEAD TimeStamp String 18 时间戳MMddHHmmssnnnn 4 HEAD SchoolId Integer 11 学校ID：学校在XXT平台的ID值，由统一平台线下提供 5 HEAD KeepProperties String 50 保留字段：方便以后扩展 6 BODY TeaName String 20 登录教师姓名：资料由SA线下维护一致 7 BODY TeaPhone String 15 登录教师号码：资料由SA线下维护一致 单点登录应答(XXT-学校) 说明：平台根据协议报文中获取的“教师姓名+号码”信息匹配平台的教师资料。 登录成功 当校讯通鉴权成功后，XXT返回单点登录后成功后的校讯通页面。如图： 登录不成功 为防