订阅接口标准说明
1.说明
1) 公共参数:

<sitename>:表示第三方应用系统域名

2) WebService名称:

Dts.asmx

3) WebService命令空间:

http://pib.nje.cn/

4) 相关地址:
Web服务地址 <sitename>/Dts.asmx
Web服务WSDL <sitename>/Dts.asmx?wsdl
5) 已实现接口示例:
2.接口
2.1 组织机构命令执行
方法名称:OrganizationCommand

调用方法:

public int OrganizationCommand(string EncrytString, string TimeSpan, string Content)

请求参数:
说明:
名称 格式 是否可空 说明
EncrytString String 加密字符串(管理员分配)。 AppKey+TimeSpan再进行MD5加密后的字符串(转换后字母都为小写), AppKey为该应用程序在基础信息库中节点的密钥) 。 例如:TimeSpan为1370585811, SecretKey为0123456789,加密前的字符串: 01234567891370585811,加密后的字符串:c0c5ad4975c735e1c856d6a6b5d4310b
TimeSpan String 时间参数(时间戳),返回自1970年以来的秒数。 时间验证与服务器时间误差不得超过30分钟,以北京时间为准。
Content String 组织机构命令内容。 详细见附录【组织机构命令XML示例】

返回类型:int
2.2 教师命令执行
方法名称:JSCommand

调用方法:

public string JSCommand(string EncrytString, string TimeSpan, string Content)

请求参数:
说明:
名称 格式 是否可空 说明
EncrytString String 加密字符串(管理员分配)。 AppKey+TimeSpan再进行MD5加密后的字符串(转换后字母都为小写), AppKey为该应用程序在基础信息库中节点的密钥) 。 例如:TimeSpan为1370585811, SecretKey为0123456789,加密前的字符串: 01234567891370585811,加密后的字符串:c0c5ad4975c735e1c856d6a6b5d4310b
TimeSpan String 时间参数(时间戳),返回自1970年以来的秒数。 时间验证与服务器时间误差不得超过30分钟,以北京时间为准。
Content String 教师命令内容。 详细见附录【教师命令XML示例】

返回类型:int
2.3 学生命令执行
方法名称:XSCommand

调用方法:

public string XSCommand(string EncrytString, string TimeSpan, string Content)

请求参数:
说明:
名称 格式 是否可空 说明
EncrytString String 加密字符串(管理员分配)。 AppKey+TimeSpan再进行MD5加密后的字符串(转换后字母都为小写), AppKey为该应用程序在基础信息库中节点的密钥) 。 例如:TimeSpan为1370585811, SecretKey为0123456789,加密前的字符串: 01234567891370585811,加密后的字符串:c0c5ad4975c735e1c856d6a6b5d4310b
TimeSpan String 时间参数(时间戳),返回自1970年以来的秒数。 时间验证与服务器时间误差不得超过30分钟,以北京时间为准。
Content String 教师命令内容。 详细见附录【学生命令XML示例】

返回类型:int

2.4 班级命令执行
方法名称:ClassInfoCommand

调用方法:

public string ClassInfoCommand(string EncrytString, string TimeSpan, string Content)

请求参数:
说明:
名称 格式 是否可空 说明
EncrytString String 加密字符串(管理员分配)。 AppKey+TimeSpan再进行MD5加密后的字符串(转换后字母都为小写), AppKey为该应用程序在基础信息库中节点的密钥) 。 例如:TimeSpan为1370585811, SecretKey为0123456789,加密前的字符串: 01234567891370585811,加密后的字符串:c0c5ad4975c735e1c856d6a6b5d4310b
TimeSpan String 时间参数(时间戳),返回自1970年以来的秒数。 时间验证与服务器时间误差不得超过30分钟,以北京时间为准。
Content String 班级命令内容。 详细见附录【班级命令XML示例】

返回类型:String

3.接口相关算法(c#)
3.1 MD5
如:加密字符:testschool1380523905abcde
返回结果:11908169dba4c9393a26980d2a6ee7a6
3.2 时间戳
如:当前时间:2013/9/26 16:07:49
时间戳:1380182865
4. 附录
4.1 组织机构命令XML示例
注意:* 为必填标签。
4.2 组织机构实体信息
属性 说明 是否字典项
code 组织机构编码
pcode 父级组织机构编码
name 组织机构名称
category 组织机构类别编号
categoryname 组织机构类别名称
typecode 组织机构类型编码
typename 组织机构类型名称
sortcode 排序字段 参考【公共服务接口】中2.1获取组织机构类型方法
4.3 教师命令XML示例
注意:* 为必填标签。
4.4 教师实体信息
属性 说明 是否字典项
Id 基础信息库中教师编号(Guid)
LoginName 用户登录名
ZZJGM 组织机构编码
XM 姓名
SFZJH 身份证件号
JZGDQZTM 教职工当前状态码
XMPY 姓名拼音
CYM 曾用名
SFZJLXM 身份证件类型码
XBM 性别码
CSRQ 出生日期
MZM 民族码
SJHM 手机号码
DZXX 电子邮箱
GHHM 固话号码
YZBM 邮政编码
TXDZ 通讯地址
CJNY 从教年月
XK 学科
ZCH 昵称
JSXL 学历
ZHYJN 职业职能
JSZW 职务(多选,以逗号分割1,2,3)
JSFG 分管(多选,以逗号分割1,2,3)
YRXSH 用人形式
RYCHH 荣誉称号
JSJL 教龄
ZTM 状态码
SGBS 省馆标识
随着基础信息库系统的功能、数据升级,会陆续开放更多的教师字段信息,具体开放的字段信息以Web公开的API为准。
请参考【基础信息库公共服务接口.docx】中GetJSOntologyElements方法获取详细信息。
4.5 学生命令XML示例
注意:* 为必填标签。
4.6 学生实体信息
属性 说明 是否字典项
Id 基础信息库中学生编号(Guid)
XSZH 学生账号(登录名)
ZZJGM 组织机构编码
XM 姓名
XMPY 姓名拼音
SFZJLXM 身份证件类型码
SFZJH 身份证件号
XBM 性别码
MZM 民族码
CSRQ 出生日期
DZYX 电子邮箱
XDM 学段码
NJ 年级
BJBH 班级编号 基础信息库中学生班级编号
ZTM 状态码
XJFH 学籍辅号
BNXH 班内学号
RXNY 入学年月
XSLYM 学生来源码
WJBS 外键标识
随着基础信息库系统的功能、数据升级,会陆续开放更多的学生字段信息,具体开放的字段信息以Web公开的API为准。
请参考【基础信息库公共服务接口.docx】中GetXSOntologyElements方法获取详细信息。
4.7 班级命令XML示例
注意:* 为必填标签。
4.8 班级实体信息
属性 说明 是否字典项
Id 基础信息库中班级编号(Guid)
OrgID 组织机构ID号
ZZJGM 组织机构编码
Grade 年级
Stage 学段
ClassCode 班级
Comment 备注
CreateDate 创建时间
随着基础信息库系统的功能、数据升级,会陆续开放更多的字段信息,具体开放的字段信息以Web公开的API为准。
请参考【基础信息库公共服务接口.docx】中GetXSOntologyElements方法获取详细信息。
4.9 状态码
状态值 状态描述
200 接收成功
400 接收失败