和教育开放平台接口协议

和教育开放平台接口协议中国移动通信集团广东有限公司第13页共13页和教育开放平台接口协议版本：v2.16中国移动通信集团广东有限公司编制：卜时熙 审批： 声明：本文件所有权和解释权归中国移动通信集团广东有限公司所有，未经书面许可，不得复制或向第三方公开。

文档修改历史记录日期版本作者修改内容2014-3-20V1.08卜时熙初始版本2014-4-10V2.00黄振标2014-5-07V2.01黄振标1、增加接口示例说明及增字段参数说明2、增加家校圈微博上传接口3、获取学生信息接口返回值补充学校ID4、微博发布接口删除参数多余参：OtherPathAndName、Uofilename、Type5、删除了第三方应用接口回调的不必要参数。2014-5-19V2.02黄振标增加OEM类型的服务消息接口2014-6-18V2.03黄振标调整应用消息和OEM消息接口参数类型，并增加查询消息了删除消息接口增加科目接口增加基础数据增量接口(3.3章节)2014-7-06V2.04黄振标1、应用消息、OEM消息的查询及删除接口增加地市ID参数。2014-07-24V2.05黄振标教师信息查询接口增加学校角色及色名名称字段(3.2.4，3.2.11)2014-11-13V2.06卜时熙1、CHK_OAUTH接口增加了Bank(年级编号)，AccountId（账号编号）。2、QRY_STUPRT_BY_CLASS，QRY_PARENT_INFO，QRY_STUDENT_INFO，QRY_PARENT_UPDATE接口增加了AccountId（账号编号）。2014-11-18V2.07卜时熙SEND_SINGLE_SMS，SEND_BATCH_SMS接口增加Token(用户登录时的)参数。增加QRY_SMS_NOREAD(获取短信上行未读内容接口)。增加QRY_SMS_READ(获取短信上行内容接口)。增加SEND_CAPTCHA_SMS（业务开通验证码下发接口）。增加PUT_CAPTCHA_ORDER（验证码开通业务接口）。2014-12-25V2.08卜时熙修改QRY_SMS_NOREAD(获取短信上行未读内容接口)，QRY_SMS_READ(获取短信上行内容接口)，增加一个OthMsgId字段。业务订购概要变更日志接口（QRY_CHG_MAIN），新的应用不可再申请该接口权限。业务订购明细变更日志接口查询业务变动情况（QRY_CHG_DETAIL）中的LogType删除，SchoolId变更为可选参数（如果提供学校ID，就与旧功能一样查询该学校的业务变更，如果不提供就查询该地市的业务变更）。2015-02-22V2.09谢君增加CHK_OAUTH2（用户验证2.0接口）增加SEND_CAPTCHA_SMS2(停用)增加PUT_CAPTCHA_ORDER2（停用）增加QRY_ORDER2（查询家长用户订购业务情况2.0接口）2015-06-10V2.10谢君1、增加CHECK_USER_TOKEN（用户验证生成TOKEN接口）2016-04-19V2.11谢君、林兴用户授权接口（CHK_OAUTH）需要增加一个学段字段（section），支持多个学段-1：无，1：幼儿园，2：小学，3：初中，4：高中增加接口SEND_IM_CLS_MESSAG（发送即时消息接口）增加接口PUT_CAPTCHA_ORDER_SI（业务开通接口只针对SI开通的分成比例为15：85的业务）增加SEND_BATH_KQ_THRMETAIL（考勤提问数据发送接口）2017-02-23V.2.12林兴修改CHK_OAUTH2（增加section字段）2、增加QRY_BATCH_ORDER（查询某个应用的订购情况）3、增加QRY_ORDER3（查询某个用户所有订购关系）2017-03-10V.2.13林兴1，增加QRY_NOINFO_USER(查询无学籍用户)2，增加SEND_CAPTCHA_SMS3(发送订购验证码3.0)3，增加PUT_CAPTCHA_ORDER3(上行验证码开通业务3.0)2017-05-09V.2.14林兴1，增加无学籍注册组件2，修改QRY_NOINFO_USER(查询无学籍用户)3，修改SEND_CAPTCHA_SMS3(对无学籍用户发送订购验证码)4，修改PUT_CAPTCHA_ORDER3(对无学籍用户上行验证码开通业务)5，修改QRY_ORDER3（引入openid）6，修改QRY_BATCH_ORDER（引入openid）2017-05-11V.2.14谢君1.下架SEND_BATCH_KQ接口2.下架SEND_BATCH_KQ_THRMETAIL接口3.增加SEND_STU_KQ接口（学生普通考勤推送接口）4.增加SEND_REAL_KQ接口（实时考勤推送接口）5.增加QRY_YKT_ERROR_RESULT（一卡通推送失败查询接口）2017-07-27V.2.15林兴1，SEND_BATCH_SMS增加发送人相关字段2，SEND_SINGLE_SMS增加发送人相关字段

目录TOC\o"1-3"\h\u288331.协议编制背景 6325442.协议概述 6179052.1.第三方应用接口使用范围 6264972.2.消息交互实现与约定 7312212.2.1.请求报文 845132.2.2.响应报文 9513.平台能力服务 10275643.1.授权认证 10153293.1.1.用户验证接口 10145813.1.2.用户验证2.0接口 12206323.1.3.单点登录组件 1327613.1.4.无学籍用户注册组件(H5) 14172463.2.基础数据 15258123.2.1.获取地市所有镇区信息接口 15237423.2.2.获取镇区所有学校信息接口 17261903.2.3.获取学校所有班级信息接口 1889993.2.4.获取学校所有教师信息接口 2060633.2.5.获取某班级所有学生信息接口 21209453.2.6.获取班级与教师关系信息接口 23208423.2.7.批量获取某班学生及家长信息接口 25105173.2.8.获取某学校信息接口 28157083.2.9.获取某班级信息接口 2947683.2.10.获取科目信息接口 30288603.2.11.获取教师用户信息接口 31164113.2.12.获取家长用户信息接口 32190973.2.13.获取学生用户信息接口 34246393.2.14.查询无学籍用户 36253763.3.基础数据增量接口 3795873.3.1.获取镇区增量数据接口 37313013.3.2.获取学校增量数据接口 39292813.3.3.获取班级增量数据接口 4121793.3.4.获取科目增量数据接口 43256393.3.5.获取教师增量数据接口 44273443.3.6.获取家长增量数据接口 46284253.3.7.获取学生增量数据接口 48109983.3.8.获取教师与班级关系的增量数据接口 50122723.3.9.获取班级对应学生增量数据接口 5113783.4.消息类接口 52158723.4.1.应用消息接口 52227093.4.2.OEM消息接口 64114133.4.3.短信消息接口 73122663.5.家校微博圈 81102973.5.1.获取家校圈微博记录接口 81314443.5.2.获取家校圈微博评论信息接口 83250463.5.3.获取家校圈微博赞明细信息接口 85192203.5.4.家校圈微博发布接口 86313953.5.5.家校圈微博分享发布接口 88229913.5.6.家校圈微博评论接口 8991393.5.7.家校圈微博赞接口 90156133.5.8.家校圈图片附件上传接口 91175883.6.业务能力 92188123.6.1.家长订购业务二次确认短信接口 92254173.6.2.业务开通验证码下发接口 93270443.6.3.验证码开通业务接口 94140183.6.4.查询家长用户订购业务情况接口 95236883.6.5.业务订购明细变更日志接口 98314283.6.6.验证码开通业务接口(代理商开通类型) 10132243.6.7.查询家长用户订购业务情况3.0接口 102327553.6.8.查询应用所有订购关系查询 10382103.6.9.业务开通验证码下发3.0 104130783.6.10.验证码开通业务3.0 105148713.7.成绩能力 106221063.7.1.获取学生成绩接口 106228923.8.一卡通能力 108178153.8.1.学生普通考勤信息批量推送接口 108271733.8.2.消费信息批量推送接口 11096643.8.3.实时考勤信息批量推送接口 11225113.8.4一卡通推送失败查询接口 11484304.第三方应用接口 116148114.1.单点登录URL 11670764.1.1.业务描述 116231174.1.2.接口描述 116222745.附录 117134405.1.附录1：地市标识列表 11710325.2.附录2：年级编号列表 117192885.3.附录3：密码的加密与解密算法 118189125.4.附录4：返回代码说明 121118545.5.附录5：短信模板参数 12222105.6.附录6：开放平台地址 122111985.6.1.服务支撑联系方式 12244345.6.2.应用联调与WSDL文件 12210995.6.3.正式平台接入 123202126.其他 12361886.1.温馨提示 123

协议编制背景为了实现和教育系统与第三方应用的顺利对接，完成两个独立系统之间的数据交互。和教育系统提供相应的数据请求接口以供第三方应用获取所需数据。为了规范和更好地实现和教育与第三方应用的数据通信，制定此接口规范。协议概述第三方应用接口使用范围开放平台将根据第三方应用级别分类开放对应接口权限，各类应用可用接口明细如下:接口分类接口功能说明接口名称应用权限备注孵化应用上架应用用户授权用户单点登录(教师、家长、学生)CHK_OAUTH用户授权单点登录基础数据获取地市所有镇区信息接口QRY_TOWN不提供获取镇区所有学校信息接口QRY_BATCH_SCHOOL不提供获取学校所有班级信息接口QRY_BATCH_CLASS不提供获取学校所有教师信息接口QRY_SCHOOL_TEACHER获取某班级所有学生信息接口QRY_CLASS_STUDENT获取班级与教师关系信息接口QRY_CLASS_TEACHER批量获取某班学生及家长信息接口QRY_STUPRT_BY_CLASS获取某个学校信息接口QRY_SCHOOL不提供获取某个班级信息接口QRY_CLASS获取科目信息QRY_SUBJECT获取教师用户信息接口QRY_TEACHER_INFO获取家长用户信息接口QRY_PARENT_INFO获取学生用户信息接口QRY_STUDENT_INFO获取镇区变更、增量数据接口QRY_TOWN_UPDATE不提供获取学校变更、增量数据接口QRY_SCHOOL_UPDATE不提供获取班级变更、增量数据接口QRY_CLASS_UPDATE不提供获取科目增量数据接口QRY_SUBJECT_UPDATE不提供获取教师与班级关系的增量数据接口QRY_CLASS_TEACHER_UPDATE不提供获取班级对应学生增量数据接口QRY_CLASS_STUDENT_UPDATE不提供应用消息向某用户推送应用消息接口SEND_SYS_PUBLIC_MESSAGE限制提供批量向某学校推送应用消息接口SEND_SYS_SCH_MESSAGE限制提供批量向某年级推送应用消息接口SEND_SYS_GRP_MESSAGE限制提供批量向某班级推送应用消息接口SEND_SYS_CLS_MESSAGE限制提供查询应用消息阅读情况接口QRY_SYS_MESSAGE限制提供删除应用消息接口DEL_SYS_MESSAGE限制提供发送即时消息接口SEND_IM_CLS_MESSAG限制提供OEM消息向某用户推送OEM消息接口SEND_OEM_PUBLIC_MESSAGE限制提供批量向某学校推送OEM消息接口SEND_OEM_SCH_MESSAGE限制提供批量向某年级推送OEM消息接口SEND_OEM_GRP_MESSAGE限制提供批量向某班级推送OEM消息接口SEND_OEM_CLS_MESSAGE限制提供查询OEM消息阅读情况接口DEL_OEM_MESSAGE限制提供删除OEM消息接口DEL_OEM_MESSAGE限制提供短信消息单个短信发送接口SEND_SINGLE_SMS不提供批量短信发送接口SEND_BATCH_SMS不提供查询短信发送状态结果接口QRY_SMS_RESULT不提供获取短信上行未读内容接口QRY_SMS_NOREAD不提供获取短信上行内容接口QRY_SMS_READ不提供家校微博圈获取家校圈微博记录接口QRY_WEIBO_MSG获取家校圈微博评论信息接口QRY_COMMENT_WEIBO_MSG获取家校圈微博赞明细信息接口QRY_PRAISE_WEIBO_MSG家校圈微博发布接口ADD_WEIBO_MSG家校圈微博分享发布接口SHARE_WEIBO_MSG家校圈微博评论接口ADD_COMMENT_WEIBO_MSG家校圈微博赞接口ADD_PRAISE_WEIBO_MSG业务模块查询营销方案信息接口（本应用+套餐）QRY_PACKAGE_INFO不提供家长订购业务二次确认短信接口PRT_SEND_COMFIRM_SMS不提供业务开通验证码下发接口SEND_CAPTCHA_SMS不提供验证码开通业务接口PUT_CAPTCHA_ORDER不提供验证码开通业务接口(代理商开通类型)PUT_CAPTCHA_ORDER_SI不提供查询家长用户订购业务情况接口QRY_ORDER不提供业务订购概要变更日志接口QRY_CHG_MAIN不提供不提供不提供业务订购明细变更日志接口QRY_CHG_DETAIL不提供查询某个用户所有订购关系QRY_ORDER3不提供某个应用的订购情况QRY_BATCH_ORDER不提供成绩模块获取学生成绩接口QRY_STU_SCORE不提供一卡通学生普通考勤信息批量推送接口SEND_STU_KQ不提供消费信息批量推送接口SEND_BATCH_DEALRECORD不提供实时考勤数据发送接口SEND_REAL_KQ不提供一卡通推送失败查询接口QRY_YKT_ERROR_RESULT不提供说明：不提供，即第三方应用无权限调用该接口；限制提供，即第三方应用调用该接口将受到次数的限制，具体限制次数请登录开放平台查阅。消息交互实现与约定如无特别说明，和教育平台与第三方应用的数据交互接口采用WebService方式，Webservice接口使用SOAP协议。需要传递的数据采用XML作为数据表达形式，全部采用同步方式实现。字符集编码用UTF-8。消息头和消息体在xml中的表现形式如下：请求报文<?xmlversion="1.0"encoding="UTF-8"?><SOAP-ENV:Envelopexmlns:SOAP-ENV="/soap/envelope/" xmlns:ns1="/edu/"> <SOAP-ENV:Body> <ns1:Request> <Version>版本号</Version> <MsgSeq>消息序列号</MsgSeq> <MsgType>消息类型</MsgType> <TimeStamp>时间戳</TimeStamp> <PerformCode>平台代码</PerformCode> <Skey>数据有效性签名</Skey> <Body>请求报文体</Body> </ns1:Request> </SOAP-ENV:Body></SOAP-ENV:Envelope>请求报文头请求报文各字段解释如下：序号父元素名称元素名称约束类型宽度描述取值说明1—Request1——请求报文头1.1RequestVersion1StringV10版本信息1.01.2RequestMsgType1StringV50消息类型根据接口定义填写1.3RequestMsgSeq1StringV30消息序列号1.4RequestTimeStamp1StringV30时间戳yyyy-MM-ddHH:mm:ssffff1.5RequestPerformCode1StringV50平台代码由和教育平台统一分配1.6RequestSkey1StringV32数据有效性签名数据有效性签名，Md5（PerformCode+TimeStamp+MsgSeq+MsgType+platformkey）输出32位全大写字母，其中platformkey是约定的密匙（和PerformCode一起由和教育平台分配）（注：“+”号为连接意思，不包含在被加密的字符串中）1.7RequestBody1请求报文体请求报文体请求报文体，是请求报文体的具体内容，以XML的格式表达，请求报文体样例如下：<MSG_BODY> <Id>123456789000</Id></MSG_BODY>响应报文<?xmlversion="1.0"encoding="utf-8"?><soapenv:Envelopexmlns:soapenv="/soap/envelope/" xmlns:ns1="/edu/"> <soapenv:Body> <ns1:Response> <Version>版本号</Version> <MsgType>消息类型</MsgType> <MsgSeq>消息序列号</MsgSeq> <TimeStamp>时间戳</TimeStamp> <Result>返回结果</Result> <Desc>结果描述</Desc> <Body>应答报文体</Body> </ns1:Response> </soapenv:Body></soapenv:Envelope>响应报文头响应报文各个字段解释如下表序号父元素名称元素名称约束类型宽度描述取值说明1—Response1——响应报文头1.1ResponseVersion1StringV10版本信息1.01.2ResponseMsgType1StringV50消息类型根据接口定义填写1.3ResponseMsgSeq1StringV30消息序列号1.4ResponseTimeStamp1StringV30时间戳yyyy-MM-ddHH:mm:ssffff1.5ResponseResult1StringV5返回结果200：成功400：BadRequest403：拒绝执行请求404：NotFound408：超时413：请求实体过大480：服务暂时无法使用486：服务器忙500：服务器内部错误503：服务器不可用504：无操作权限700：其他错误1.6ResponseDesc1StringV100返回结果描述1.7ResponseBody1响应报文体响应报文体应答报文体，是应答报文体的具体内容，以XML的格式表达，应答报文体样例如下：<MSG_BODY><TeacherId>12323</TeacherId><TeacherName>刘星</TeacherName><SchoolId>9765</SchoolId></MSG_BODY>Wsdl文件所有webservices均使用同一个wsdl文件。WSDL文件生成地址请向接口人获取。平台能力服务授权认证用户验证接口业务描述第三方应用调用此接口完成用户登录的有效性验证。该接口实现两个验证方式：方式一：单点登录验证。用户在和教育门户通过点击图标(uri)跳转到第三方应用的平台，uri会增加token参数及对应的用户值，第三方应用平台获取到该参数后调用此接口完成验证，如果验证通过会返回用户的基本信息。如果验证不通过会返回603错误，并提示token无效。方式二：引用和教育登录组件实现单点认证。第三方应用平台调用和教育平台的登录组件（http://.../oauth/login.do?appCode=123）。用户在界面输入和教育平台的账号与密码后提交，登录组件将进行登录验证检查，检查通过后组件会根据第三方应用的应用code（appCode）找到该应用的回调地址(在开放平台申请接入时注册的地址)，并返回token参数给第三方应用，第三方应用平台获取到该参数后调用此接口完成验证。接口描述MsgType：CHK_OAUTH请求：第三方应用–>和教育平台序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYToken1StringV32登录验证标记登录时由和教育平台提供。响应：和教育平台–>第三方应用和教育平台返回查询结果。序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYCityId1StringV20地区代码例如:gz,zs1.2MSG_BODYUserId1Integer和教育平台的用户ID学生ID，老师ID或家长用户ID1.3MSG_BODYLoginName1StringV50登录名如果是手机号码，则返回处理后字符串，即中间四位用*号替换1.4MSG_BODYUserName1StringV50真实姓名1.5MSG_BODYHeadImage?StringV200头像地址1.6MSG_BODYEMail?StringV200邮箱地址1.7MSG_BODYRoleType1Integer用户角色1老师，2学生，3家长1.8MSG_BODYSchoolId?Integer学校ID如果是家长则学校ID为空1.9MSG_BODYIcNo?StringV20IC卡号1.10MSG_BODYSex?StringV10性别1.11MSG_BODYCheckCode?StringV100验证代码1.12MSG_BODYBankV2.06版本新增参数V2.06版本新增参数?Integer年级编号只有用户角色为学生、家长时此字段有效,见附件二1.13MSG_BODYsection?StringV50学段支持多个学段-1：无，1：幼儿园，2：小学，3：初中，4：高中。多个用逗号’,’隔开1.14MSG_BODYAccountIdV2.06版本新增参数V2.06版本新增参数1Integer账号编号这个是账号编号，其性质与用户ID不同。例如一个家长有多个孩子，那么他的账号编号是同一个但是用户ID不同。用户验证2.0接口业务描述第三方应用调用此接口完成用户(包括学籍用户和互联网用户)登录的有效性验证。该接口实现两个验证方式：方式一：单点登录验证。用户在和教育门户通过点击图标(uri)跳转到第三方应用的平台，uri会增加token参数及对应的用户值，第三方应用平台获取到该参数后调用此接口完成验证，如果验证通过会返回用户的基本信息。如果验证不通过会返回714错误，并提示token无效。方式二：引用和教育登录组件实现单点认证。第三方应用平台调用和教育平台的登录组件（http://.../oauth/login.do?appCode=123）。用户在界面输入和教育平台的账号与密码后提交，登录组件将进行登录验证检查，检查通过后组件会根据第三方应用的应用code（appCode）找到该应用的回调地址(在开放平台申请接入时注册的地址)，并返回token参数给第三方应用，第三方应用平台获取到该参数后调用此接口完成验证。备注：学籍用户：所有字段有效。互联网用户：用户ID(OpenId)、用户角色、用户类型等字段有效，其他无效。接口描述MsgType：CHK_OAUTH2请求：第三方应用–>和教育平台序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYToken1StringV32登录验证标记登录时由和教育平台提供响应：和教育平台–>第三方应用和教育平台返回查询结果。序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYCityId？StringV20地区代码例如:gz,zs1.2MSG_BODYUserId1Integer用户IDUserType=0时：学生ID，老师ID或家长用户ID;1.3MSG_BODYOpenId1String用户IDUserType=1时，用户唯一标识1.4MSG_BODYUserType1Integer用户类型0学籍用户、1无学籍用户(互联网注册)1.5MSG_BODYLoginName1StringV50登录名如果是手机号码，则返回处理后字符串，即中间四位用*号替换1.6MSG_BODYUserName?StringV50真实姓名1.7MSG_BODYHeadImage?StringV200头像地址1.8MSG_BODYEMail?StringV200邮箱地址1.9MSG_BODYRoleType1Integer用户角色1老师，2学生，3家长1.10MSG_BODYSchoolId?Integer学校ID如果是家长则学校ID为空1.11MSG_BODYIcNo?StringV20IC卡号1.12MSG_BODYSex?StringV10性别1.13MSG_BODYCheckCode?StringV100验证代码1.14MSG_BODYBank?Integer年级编号只有用户角色为学生、家长时此字段有效,见附件二1.15MSG_BODYAccountId1Integer账号编号这个是账号编号，其性质与用户ID不同。例如一个家长有多个孩子，那么他的账号编号是同一个但是用户ID不同。1.16MSG_BODYsection?StringV50学段支持多个学段-1：无，1：幼儿园，2：小学，3：初中，4：高中。多个用逗号’,’隔开单点登录组件业务描述第三方应用平台可调用该组件，并结合“用户验证接口”，实现用户单点登录。组件描述组件地址：/oauth/login.do?appCode=hefte开放平台提供了一个登录地址,以方便用户使用和教育平台的账号与密码来登录第三方平台。appCode参数为第三方应用的应用code。合作商在创建应用的自己的应用时可以指定。如果验证通过，开放平台会生成一个token参数，并访问合作商创建应用时填写的应用入口地址（例如：/?token=68de6b065869ad1bd38d3c0bd0c9b6b8）。第三方应用程序拿到token值后，需要调用“用户验证接口”来判断该token是不是开放平台生成的token。（图三，用户登录界面）无学籍用户注册组件(H5)业务描述无学籍用户注册账号通过两种方式来进行：方式一：通过和教育门户进行注册，地址：方式二：通过开放平台提供的组件来进行注册。第三方应用平台调用和教育平台的用户注册组件。用户在页面输入注册需要的信息后，向用户手机发送一条验证码，验证码验证正确之后，会注册一个对应的无学籍账户，并通过单点登录的地址返回token参数给第三方应用，第三方应用平台获取到该参数后调用用户验证2.0接口获得用户信息，并开展后续业务。其中参数appCode为必填，mobile为非必填。组件地址组件地址：http://.../oauth/register.do?appCode=XXX&mobile=XXX基础数据获取地市所有镇区信息接口业务描述可通过此接口查询各地市的镇区基本信息，包括镇区ID、镇区名称、镇区代码、排序号。接口描述MsgType：QRY_TOWN请求：第三方应用–>和教育平台序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYCityId1StringV10和教育平台的地市标识取值详见附录一响应：和教育平台–>第三方应用和教育平台返回查询结果。序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYTownList1镇区列表1.2TownListTownEntity1镇区1.2.1TownEntityCityId1StringV10和教育平台的地市标识取值详见附录一1.2.2TownEntityTownId1Integer镇区ID1.2.3TownEntityTownName1StringV30镇区名称1.2.4TownEntityCode1StringV3镇区代码1.2.5TownEntitySequence?Integer排序号1.2.6TownEntityModifyTime?StringV20最后修改时间格式：yyyy-MM-ddHH:mm:ss示例请求消息体实例：<MSG_BODY><CityId>zs</CityId></MSG_BODY>响应消息实例：<MSG_BODY><TownList><TownEntity><TownId>101</TownId><TownName>东区</TownName><CityId>zs</CityId><Code>002</Code><Sequence>999</Sequence></TownEntity><TownEntity><TownId>104</TownId><TownName>火炬区</TownName><CityId>zs</CityId><Code>003</Code><Sequence>999</Sequence></TownEntity></TownList></MSG_BODY>获取镇区所有学校信息接口业务描述通过镇区ID获取该镇区下的所有学校信息，包括学校ID、所属地区镇区、学校名称、学校类型。接口描述MsgType：QRY_BATCH_SCHOOL请求：第三方应用–>和教育平台序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYTownId1Integer镇区ID响应：和教育平台–>第三方应用和教育平台返回查询结果。序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYSchool1Integer学校实体1.2.1SchoolSchoolID1Integer学校ID1.2.2SchoolAreaId1Integer地区ID1.2.3SchoolAreaName1StringV50地区1.2.4SchoolTownId1Integer镇区ID1.2.5SchoolTownName1StringV100镇区1.2.6SchoolSchoolName1StringV100学校名字1.2.7SchoolSection1Integer学校类型学段：0幼儿园1小学2初中3高中7九年一贯制8完全中学10十二年一贯制5高校6职业技术学校9特殊教育学校1.2.8SchoolCityId1StringV10和教育平台的地市标识取值详见附录一1.2.9SchoolModifyTime?StringV20最后修改时间格式：yyyy-MM-ddHH:mm:ss示例请求消息体实例：<MSG_BODY><TownId>101</TownId></MSG_BODY>响应消息实例：<MSG_BODY><School><SchoolId>123</SchoolId><AreaId>1</AreaId><AreaName>中山</AreaName><TownName>东区</TownName><SchoolName>东区长江小学</SchoolName><Section>0</Section><TownId>101</TownId><CityId>zs</CityId></School><School><SchoolId>124</SchoolId><AreaId>1</AreaId><AreaName>中山</AreaName><TownName>东区</TownName><SchoolName>东区沙岗小学</SchoolName><Section>0</Section><TownId>101</TownId><CityId>zs</CityId></School></MSG_BODY>获取学校所有班级信息接口业务描述通过学校ID获取该校的所有班级信息，包括班级ID、学校ID、所在年级、班级类型。接口描述MsgType：QRY_BATCH_CLASS请求：第三方应用–>和教育平台序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYSchoolId1Integer学校ID响应：和教育平台–>第三方应用和教育平台返回查询结果。序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYClassList1班级列表1.1.1ClassListClassEntity1班级ClassEntityClassId1Integer班级IDClassEntitySchoolId1Integer学校IDClassEntityGradeId1Integer年级IDClassEntityGradeName1StringV50年级名称ClassEntityBank1Integer年级编号见附件二ClassEntityClassName1StringV50班级名称ClassEntityClassType1Integer班级类型1正规班,2兴趣班ClassEntityModifyTime?StringV20最后修改时间格式：yyyy-MM-ddHH:mm:ss示例请求消息体实例：<MSG_BODY><SchoolId>123</SchoolId></MSG_BODY>响应消息实例：<MSG_BODY><ClassList><ClassEntity><ClassId>12001</ClassId><SchoolId>123</SchoolId><GradeId>23924</GradeId><GradeName>三年级</GradeName><Bank>-3</Bank><ClassName>三(3)班</ClassName><ClassType>1</ClassType></ClassEntity><ClassEntity><ClassId>12345</ClassId><SchoolId>123</SchoolId><GradeId>23656</GradeId><GradeName>二年级</GradeName><Bank>-5</Bank><ClassName>二(1)班</ClassName><ClassType>1</ClassType><ModifyTime>2014-02-1812:00:00</ModifyTime></ClassEntity></ClassList></MSG_BODY>获取学校所有教师信息接口业务描述通过学校ID获取该学校的所有教师帐号信息，包括所属地区镇区、学校名称、教师ID、登录帐号、真实姓名、头像地址、邮箱地址、IC卡号、性别。接口描述MsgType：QRY_SCHOOL_TEACHER请求：第三方应用–>和教育平台序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYSchoolId1Integer学校ID响应：和教育平台–>第三方应用和教育平台返回查询结果。序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYTeacherInfo?1.1.1TeacherInfoSchoolId1Integer学校ID1.1.2TeacherInfoAreaName1StringV50地区1.1.3TeacherInfoTownName1StringV100镇区1.1.4TeacherInfoSchoolName1StringV100学校名字1.1.5TeacherInfoTeacherId1Integer老师ID1.1.6TeacherInfoLoginName1StringV50登录帐号1.1.7TeacherInfoUserName1StringV50真实姓名1.1.8TeacherInfoHeadImage?StringV200头像地址1.1.9TeacherInfoEMail?StringV200邮箱地址1.1.10TeacherInfoIcNo?StringV20IC卡号1.1.11TeacherInfoSex?StringV10性别男，女，未知1.1.12TeacherInfoRoleId？Integer角色ID1.1.13TeacherInfoRoleName？StringV100角色名称1.1.14TeacherInfoModifyTime?StringV20最后修改时间格式：yyyy-MM-ddHH:mm:ss示例请求消息体实例：<MSG_BODY><SchoolId>124</SchoolId></MSG_BODY>响应消息实例：<MSG_BODY><TeacherInfo><SchoolId>124</SchoolId><AreaName>中山</AreaName><TownName>东区</TownName><SchoolName>东区沙岗小学</SchoolName><TeacherId>198362</TeacherId><LoginName>zswangxiaoya</LoginName><UserName>王小丫</UserName><EMail>wangxiaoya@163.com</EMail><Sex>未知</Sex></TeacherInfo><TeacherInfo><SchoolId>124</SchoolId><AreaName>中山</AreaName><TownName>东区</TownName><SchoolName>东区沙岗小学</SchoolName><TeacherId>299596</TeacherId><LoginName>zswangxiaomin</LoginName><UserName>王小明</UserName><Sex>未知</Sex></TeacherInfo></MSG_BODY>获取某班级所有学生信息接口业务描述通过班级ID获取该班级所有对应的学生帐号信息，包括学校ID、班级ID、班级名称、学生ID、登录帐号、学籍号、真实姓名、IC卡号、性别。接口描述MsgType：QRY_CLASS_STUDENT请求：第三方应用–>和教育平台序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYCityId1StringV10和教育平台的地市标识取值详见附录一1.2MSG_BODYClassId1Integer班级ID响应：和教育平台–>第三方应用和教育平台返回查询结果。序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYStudentInfo11.1.1StudentInfoSchoolId1Integer学校ID1.1.2StudentInfoClassIdInteger班级ID1.1.3StudentInfoClassName1StringV50班级名称1.1.4StudentInfoStudentIdSringV50学生ID(用户ID)1.1.5StudentInfoLoginNameStringV50登录帐号1.1.6StudentInfoStudentSeq1StringV12学籍号1.1.7StudentInfoUserName1StringV50真实姓名1.1.8StudentInfoHeadImage?StringV200头像地址1.1.9StudentInfoEMail?StringV200邮箱地址1.1.10StudentInfoIcNo?StringV20IC卡号1.1.11StudentInfoSex?StringV10性别1.1.12StudentInfoModifyTime?StringV20最后修改时间格式：yyyy-MM-ddHH:mm:ss示例请求消息体实例：<MSG_BODY><CityId>zs</CityId><ClassId>103768</ClassId></MSG_BODY>响应消息实例：<MSG_BODY><StudentInfo><ClassId>103768</ClassId><ClassName>小二(2)班</ClassName><GradeId>40247</GradeId><GradeName>二级年</GradeName><StudentId>331056</StudentId><StudentSeq>130900411044</StudentSeq><UserName>张三</UserName><Sex>男</Sex><SchoolId>50091</SchoolId></StudentInfo><StudentInfo><ClassId>103768</ClassId><ClassName>小二(2)班</ClassName><GradeId>40247</GradeId><GradeName>二级年</GradeName><StudentId>331056</StudentId><StudentSeq>130900411056</StudentSeq><UserName>李四</UserName><Sex>男</Sex><SchoolId>50091</SchoolId></StudentInfo></MSG_BODY>获取班级与教师关系信息接口业务描述通过该接口获取班级与教师之间的关系信息，包括该教师所教的科目、教师角色类型。该接口提供通过班级ID获取所有老师对应数据，也可通过教师ID获取该老师对应的班级数据。接口描述MsgType：QRY_CLASS_TEACHER请求：第三方应用–>和教育平台序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYClassId?Integer班级ID两个值中必需有一个不能为空1.2MSG_BODYTeacherId?Integer老师ID响应：和教育平台–>第三方应用和教育平台返回查询结果。序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYRelations?1.1.1RelationsClassTeacherRelation*ClassTeacherRelationClassId1Integer班级IDClassTeacherRelationGradeId1Integer年级IDClassTeacherRelationGradeName1StringV50年级名称ClassTeacherRelationClassName1StringV50班级名称ClassTeacherRelationTeacherId1Integer老师IDClassTeacherRelationLoginName1StringV50登录帐号ClassTeacherRelationUserName1StringV50真实姓名ClassTeacherRelationHeadImage?StringV200头像地址ClassTeacherRelationEMail?StringV200邮箱地址0ClassTeacherRelationUserType1Integer角色类型1班主任，2任课老师，3班主任兼任课老师,0不符合的数据，4其他角色1ClassTeacherRelationSubjectList?科目列表1.1SubjectListSubject*科目1.1.1SubjectSubjectId1Integer科目ID1.1.2SubjectSubjectName1StringV50科目名称示例请求消息体实例：<MSG_BODY><ClassId>605668</ClassId><TeacherId>2552341</TeacherId></MSG_BODY>响应消息实例：<MSG_BODY><Relations><ClassTeacherRelation><ClassId>605668</ClassId><ClassName>小六(1)班</ClassName><GradeId>514341</GradeId><GradeName>小六</GradeName><TeacherId>2552341</TeacherId><LoginName>jmwujingrang</LoginName><UserName>吴敬让</UserName><SubjectList><Subject><SubjectId>1</SubjectId><SubjectName>语文</SubjectName></Subject><Subject><SubjectId>2</SubjectId><SubjectName>数学</SubjectName></Subject><Subject><SubjectId>3</SubjectId><SubjectName>英语</SubjectName></Subject></SubjectList><UserType>3</UserType></ClassTeacherRelation><ClassTeacherRelation><ClassId>605668</ClassId><ClassName>小六(1)班</ClassName><GradeId>514341</GradeId><GradeName>小六</GradeName><TeacherId>1499173</TeacherId><LoginName>jmkpjjxx</LoginName><UserName>胡楚杰</UserName><SubjectList><Subject><SubjectId>1</SubjectId><SubjectName>语文</SubjectName></Subject><Subject><SubjectId>2</SubjectId><SubjectName>数学</SubjectName></Subject></SubjectList><UserType>2</UserType></ClassTeacherRelation></Relations></MSG_BODY>批量获取某班学生及家长信息接口业务描述第三方应用调用此接口查询某个班级的所有学生与家长信息，包括学生ID、学籍号、真实姓名、对应的家长姓名、手机号码。此接口可以一次查询出学生和家长的基础数据，解决需要多次查询其他接口才能获取到基础数据的情况。接口描述MsgType：QRY_STUPRT_BY_CLASS请求：第三方应用–>和教育平台序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYCityId1StringV10和教育平台的地市标识取值详见附录一1.2MSG_BODYClassId?Integer班级ID响应：和教育平台–>第三方应用和教育平台返回查询结果。序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYStudentList学生列表1.1.1StudentListStudentEntity学生StudentEntityStudentId1Integer学生IDStudentEntityStudentSeq1StringV12学籍号StudentEntityLoginName1StringV50登录名StudentEntityUserName1StringV50真实姓名StudentEntityHeadImage?StringV200头像地址StudentEntityEMail?StringV200邮箱地址StudentEntitySexStringV10性别StudentEntityIcNoStringV20IC卡号StudentEntityParentList1家长列表ParentListParentEntity1家长.1ParentEntityParentId1Integer家长ID.2ParentEntityParLoginName1StringV50家长登录名手机号码，返回处理后字符串，即中间四位用*号替换.3ParentEntityParUserName1StringV50家长真实姓名.4ParentEntityParHeadImage?StringV200家长头像地址.5ParentEntityParEMail?StringV200家长邮箱地址.6ParentEntityParIcNoStringV20家长IC卡号.7ParentEntityCheckCode?String验证代码保留字段.8ParentEntityAccountIdV2.06版本新增参数V2.06版本新增参数?Integer家长账号编号这个是账号编号，其性质与用户ID不同。例如一个家长有多个孩子，那么他的账号编号是同一个但是用户ID不同。当用户没有在和教育平台生成账号时账号编号为空。示例请求消息体实例：<MSG_BODY><CityId>zs</CityId><ClassId>1030104</ClassId></MSG_BODY>响应消息实例：<MSG_BODY><StudentList><StudentEntity><StudentId>3052963</StudentId><StudentSeq>120900465406</StudentSeq><LoginName>zsyeyuxuan2</LoginName><UserName>叶宇轩</UserName><ParentList><ParentEntity><ParentId>4961669</ParentId><ParLoginName>138****0136</ParLoginName><ParUserName>叶宇轩家长</ParUserName><CheckCode>f54cp5Cfh1SW/R6EALkVMpuJrr1tgEtGb7KSzaKTNBaRYMIbRjHVRQ</CheckCode></ParentEntity><ParentEntity><ParentId>4961670</ParentId><ParLoginName>137****4325</ParLoginName><ParUserName>叶宇轩家长2</ParUserName><CheckCode>8660Iai92Dioxn3SsV/oONtNy5BoWWqFCizy5ZXHm6AHjFVMgv55hw</CheckCode></ParentEntity></ParentList></StudentEntity><StudentEntity><StudentId>3052964</StudentId><StudentSeq>120900465407</StudentSeq><LoginName>zsxuruize</LoginName><UserName>徐瑞泽</UserName><ParentList><ParentEntity><ParentId>4961671</ParentId><ParLoginName>135****9946</ParLoginName><ParUserName>徐瑞泽家长</ParUserName><CheckCode>6770AHUr80YdncAxXSs/cC8vsqREQuW3ofqNSfFDn18NCdlcHhP/Hw</CheckCode></ParentEntity></ParentList></StudentEntity></StudentList></MSG_BODY>获取某学校信息接口业务描述可通过此接口获取指定学校的基本信息，包括所属地区镇区、学校名称、学校类型。接口描述MsgType：QRY_SCHOOL请求：第三方应用–>和教育平台序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYSchoolId1Integer学校ID响应：和教育平台–>第三方应用和教育平台返回查询结果。序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYSchoolId1Integer学校ID1.2MSG_BODYAreaId1Integer地区ID1.3MSG_BODYAreaName1StringV50地区1.4MSG_BODYTownId1Integer镇区ID1.5MSG_BODYTownName1StringV100镇区1.6MSG_BODYSchoolName1StringV100学校名字1.7MSG_BODYSection1Integer学校类型学段：0幼儿园1小学2初中3高中7九年一贯制8完全中学10十二年一贯制5高校6职业技术学校9特殊教育学校1.8MSG_BODYCityId1StringV10和教育平台的地市标识取值详见附录一1.9MSG_BODYModifyTime?StringV20最后修改时间格式：yyyy-MM-ddHH:mm:ss示例请求消息体实例：<MSG_BODY><SchoolId>49526</SchoolId></MSG_BODY>响应消息实例：<MSG_BODY><SchoolId>49526</SchoolId><AreaId>1</AreaId><AreaName>中山</AreaName><TownName>火炬区</TownName><SchoolName>开发区濠头中学</SchoolName><Section>4</Section><TownId>3184</TownId><CityId>zs</CityId></MSG_BODY>获取某班级信息接口业务描述第三方应用调用此接口可以获取到班级的基本信息，包括学校ID、所属年级、班级名称、班级类型。可以通过学校ID来查询这个学校的所有的班级，也可以通过指定班级ID查询某一个班级。接口描述MsgType：QRY_CLASS请求：第三方应用–>和教育平台序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYClassId?Integer班级ID响应：和教育平台–>第三方应用序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYClassId1Integer班级ID1.2MSG_BODYSchoolId1Integer学校ID1.3MSG_BODYGradeId1Integer年级ID1.4MSG_BODYGradeName1StringV50年级名称1.5MSG_BODYBank1Integer年级编号见附件二1.6MSG_BODYClassName1StringV50班级名称1.7MSG_BODYClassType1Integer班级类型1正规班,2兴趣班1.8MSG_BODYModifyTime?StringV20最后修改时间格式：yyyy-MM-ddHH:mm:ss示例请求消息体实例：<MSG_BODY><CityId>zs</CityId><ClassId>1090555</ClassId></MSG_BODY>响应消息实例：<MSG_BODY><ClassId>1090555</ClassId><SchoolId>50079</SchoolId><GradeId>420037</GradeId><GradeName>幼儿园小班</GradeName><Bank>-5</Bank><ClassName>幼儿园小班(1)班</ClassName><ClassType>1</ClassType></MSG_BODY>获取科目信息接口业务描述通过该接口可取得和教育平台的基础学科和学校自定义学科信息。接口描述MsgType：QRY_SUBJECT请求：第三方应用–>和教育平台序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYSchoolId1Integer学校ID1.2MSG_BODYSubjectId1Integer科目ID响应：和教育平台–>第三方应用序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYSubjectList1Integer1.2SubjectListSubjectEntity1Integer1.2.1SubjectEntitySubjectId1Integer科目ID1.2.2SubjectEntitySubjectName1StringV50科目名称1.2.3SubjectEntitySubjectType1Integer科目类型1.2.4SubjectEntityModifyTime?StringV20最后修改时间格式：yyyy-MM-ddHH:mm:ss示例请求消息体实例：响应消息实例：获取教师用户信息接口业务描述第三方应用调用此接口可以获取到教师用户的基本信息，包括教师ID、登录名、真实姓名、头像地址、邮箱地址、所属学校、IC卡号、性别。接口描述MsgType：QRY_TEACHER_INFO请求：第三方应用–>和教育平台序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYCityId1StringV10和教育平台的地市标识取值详见附录一1.2MSG_BODYUserId1Integer和教育平台的用户ID老师ID响应：和教育平台–>第三方应用和教育平台返回查询结果。序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYUserId1Integer和教育平台的用户ID老师ID1.2MSG_BODYLoginName1StringV50登录名如果是手机号码，则返回处理后字符串，即中间四位用*号替换1.3MSG_BODYUserName1StringV50真实姓名1.4MSG_BODYHeadImage?StringV200头像地址1.5MSG_BODYEMail?StringV200邮箱地址1.6MSG_BODYSchoolId?Integer学校ID1.7MSG_BODYIcNo?StringIC卡号1.8MSG_BODYSex?String性别1.9MSG_BODYRoleId？Integer角色ID1.10MSG_BODYRoleName？StringV100角色名称1.11MSG_BODYCheckCode?StringV100验证代码1.12MSG_BODYModifyTime?String最后修改时间格式：yyyy-MM-ddHH:mm:ss示例请求消息体实例：<MSG_BODY><CityId>zs</CityId><UserId>2552341</UserId></MSG_BODY>响应消息实例：<MSG_BODY><UserId>2552341</UserId><LoginName>jmwujingrang</LoginName><UserName>吴敬让</UserName><SchoolId>59187</SchoolId><Sex>0</Sex><CheckCode>b66fqcCpedA8R0imjrc3TUS3VcZsTg6PtqZzBd0nn530xQ3wI96g3Q</CheckCode><ModifyTime>2012-09-1916:39:22</ModifyTime></MSG_BODY>获取家长用户信息接口业务描述第三方应用调用此接口可以通过家长用户ID获取到家长用户的基本信息，包括登录名、家长姓名、IC卡号、性别、对应的学生信息。接口描述MsgType：QRY_PARENT_INFO请求：第三方应用–>和教育平台序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYCityId1StringV10和教育平台的地市标识取值详见附录一1.2MSG_BODYUserId1Integer和教育平台的用户ID家长用户ID响应：和教育平台–>第三方应用和教育平台返回查询结果。序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYUserId1和教育平台的用户ID家长用户ID1.2MSG_BODYLoginName1StringV50登录名如果是手机号码，则返回处理后字符串，即中间四位用*号替换1.3MSG_BODYUserName1StringV50真实姓名1.4MSG_BODYHeadImage?StringV200头像地址1.5MSG_BODYEMail?StringV200邮箱地址1.6MSG_BODYSchoolId?Integer学校ID如果是家长则学校ID为空1.7MSG_BODYIcNo?StringV20IC卡号1.8MSG_BODYSex?StringV10性别1.9MSG_BODYCheckCode?StringV100验证代码1.10MSG_BODYAccountIdV2.06版本新增参数V2.06版本新增参数?Integer家长账号编号这个是账号编号，其性质与家长用户ID。例如一个家长有多个孩子，那么他的账号编号是同一个但是用户ID不同。当用户没有在和教育平台生成账号时账号编号为空。1.11MSG_BODYModifyTime?StringV20最后修改时间格式：yyyy-MM-ddHH:mm:ss1.12MSG_BODYStuUserId?StringV50学生用户ID1.13MSG_BODYStuLoginName?StringV50学生帐号1.14MSG_BODYStuUserName?StringV50学生姓名1.15MSG_BODYStuSchoolId?Integer学生所在学校ID1.16MSG_BODYStuClassId?Integer学生所在班级ID1.17MSG_BODYStuIcNo?StringV20学生IC卡号1.18MSG_BODYStuSex?StringV10学生性别示例请求消息体实例：<MSG_BODY><CityId>zs</CityId><UserId>5384448</UserId></MSG_BODY>响应消息实例：<MSG_BODY><UserId>5384448</UserId><UserName>刘子墨家长</UserName><SchoolId>49896</SchoolId><StuUserId>3213283</StuUserId><StuLoginName>liuzimo2</StuLoginName><StuUserName>刘子墨</StuUserName><StuSchoolId>49896</StuSchoolId><StuClassId>502902</StuClassId><StuSex>男</StuSex><CheckCode>016dLzL6ON1LdDg0DN+EP2DQUXfwzc36w8ShOsaHmn71Zzhx3asyoQ</CheckCode></MSG_BODY>获取学生用户信息接口业务描述第三方应用调用此接口可以获取到学生用户的基本信息，包括学校ID、班级ID、班级名称、学生ID、登录帐号、学籍号、真实姓名、IC卡号、性别、对应的家长列表。接口描述MsgType：QRY_STUDENT_INFO请求：第三方应用–>和教育平台序号父元素名称元素名称约束类型宽度描述取值说明1.1MSG_BODYCityId1StringV10和教育平台的地市标识取值详见附录一1.2MSG_BODYUserId1Integer和教育平台的用户ID学生用户ID响应：和教育平台–>第三方应用和教育平台返