【龙岩市教育数据共享服务平台】
共享服务接口
(版本号 V1.0)
文件更改摘要
日期 | 版本号 | 修订说明 | 修订人 | 审核人 |
2022/03/12 | 1.0 | 新增根据条件获取教师信息列表接口 | 童倩 | 苏松福 |
龙岩市教育数据共享服务平台在政务信息网和政务外网、互联网区提供Restful接口,各部门业务系统通过调用该Restful接口,实现政务数据实时共享。
限制类型 | 限制说明 |
传输字符编码格式 | 平台接口采用的是UTF-8编码格式 |
传输数据格式 | 平台接口采用JSON格式 |
为了保证汇聚共享平台对外提供的统一接口安全可靠、简易兼容,接口规范应满足如下原则:
(1) 接口具有普遍的适应性;
(2) 使用简单、快捷的方式实现其他系统的接入;
(3) 接口应充分考虑省汇聚共享平台的应用扩展情况;
(4) 保证接口数据在省汇聚平台与用户系统的一致性;
(5) 接口调用能够方便的形成,并能在接入方顺利地实现;
(6) 在满足功能要求的前提下,使接口数据量最少;
(7) 接口数据传输控制策略可靠且完善;
(8) 具有可靠的接口数据出错返回机制。
所有接口调用均采用HTTP远程调用方式,客户端调用并同步返回响应。数据格式: json
1. 请求方式:get/post, 服务地址url格式为http://domain/[service]/[servicename]
其中:domain为服务域名、service为服务名称、servicename 为API名称.
2. 协议消息头包含以下属性:
Content-Type:application/json;charset=utf-8;
3. 请求header包含以下参数:
user-date: 调用日期。格式yyyyMMddHHmmssSSS。17位日期字符串,小时采用24小时格式,如:20160101160758675;
user-params:请求参数。Get请求格式为:xx=xx&xx=xx。Post请求格式为json字符串。参数中含中文需进行URL的UTF-8编码
authorization: 鉴权码,其中,鉴权码(authorition)=dc:{apikey}:{signature}。鉴权码由三部分组成,他们之间以英文冒号隔开;(详细请参考2.2)
1. 响应报文媒体类型为application/json;charset=utf-8.
apikey | 管理人员分配 |
secretkey | 管理人员分配 |
authorization | 第一部分:固定值为dc。 第二部分:用户申请的apikey。 第三部分:数据签名(signature)。 例如: dc:test-apikey:ODExQUJENUFCRTBDQTc5NzM4RkQ2RTUzQzE2MDQyNUY= 数据签名(signature),加密格式如下: signature= BASE64{ Hmac_sha1{ user-params + 换行符 + user-date + 换行符 } } 数据签名由hmac_sha1加密后在经base64编码。hmac_sha1密钥为用户申请的secretkey。}
|
user-date | 用日期。格式yyyyMMddHHmmssSSS。17位日期字符串,小时采用24小时格式,如:20160101160758675;
|
user-params | 请求参数。Get请求格式为:xx=xx&xx=xx。Post请求格式为json字符串。 参数中含中文需进行URL的UTF-8编码 |
API调用示例代码:
下载Api调用示例,把代码导入开发工具,查看其中的RequestApiTest类,修改其中的 APIKEY,SECRETKEY,然后根据相应的请求方式,修改接口地址进行测试。
接口访问地址 | http://open-api.longyanedu.net/user/getTeacherList | |||
接口方式 | HTTP | 提交方式 | Post application/json
| |
入参 | 名称 | 必填 | 数据类型 | 说明 |
org_ids | 是 | String[] | 机构id数组 | |
columns | 是 | String[] | 需要返回的字段( 附:教师可返字段说明) | |
其他查询字段 | 其他查询条件参照 附:教师可返字段说明 | |||
出参 | 名称 | 数据类型 | 说明 | |
code | String | 结果编码,000000:成功 | ||
message | String | 结果描述 | ||
请求示例 | {"columns":["user_id","name","idcard_number","enter_school_date"],"org_ids":["d0d32e99033e4be185b112068b7b2c56","6f5fc3ce9cc9494ba142ed91db23df7b"]} | |||
返回示例 | {"code":"000000","message":"success","result":[{"idcard_number":"341226198211140127","user_id":"13b3688fd8a241929eed54f606efda8b","name":"杨俊","enter_school_date":null}],"status":"OK"} | |||
返回说明 | 参考 附:教师可返字段说明 | |||
附:教师可返字段说明
字段名 | 说明 | 备注 |
user_id | 用户id |
|
name | 用户姓名 |
|
status | 状态 | 0:未激活 |
nick_name | 昵称 |
|
avatar | 头像 | 头像地址 |
province_code | 所在省编号 |
|
city_code | 所在市编号 |
|
area_code | 所在区编号 |
|
account | 账号 | 普通,手机,邮箱,证件编号等。多个账号用逗号隔开 |
person_id | 教职工号 |
|
former_name | 曾用名 |
|
sex | 性别 |
|
place_of_birth | 出生地 |
|
nationality_cd | 民族 |
|
idcard_type | 身份证类型 |
|
idcard_number | 身份证号 |
|
birthday | 生日 |
|
native_place | 籍贯 |
|
nation_cd | 国籍/地区 |
|
political_landscape | 政治面貌 |
|
marital_status | 婚姻状况 |
|
health | 健康状况 |
|
type | 教职工类别 |
|
whether_at | 是否在编 |
|
telphone | 手机号 |
|
home_phone | 联系电话 |
|
电子邮箱 |
| |
qq_number | 其他联系方式 |
|
home_address | 通讯地址 |
|
school_id | 学校ID |
|
school_nm | 学校名称 |
|
main_period | 主任学段 | 字典详见附件:基础学科字典 |
main_subject | 主任学科 | 字典详见附件:基础学科字典 |
personal | 岗位类别 | 1:专任教师,2:行政人员,3:教辅人员,4:工勤人员,5:校办企业职工,6:代课教师,7:兼任(职)教师,9:其他 |
position | 行政职务 | 10:正校级,20:副校级,30:中层正职,40:中层副职 |
is_administration_course | 是否行政兼课 |
|
date_of_employment | 参加工作年月 |
|
enter_school_date | 进本校年月 |
|
source | 教职工来源 |
|
way_of_person | 用人形式 |
|
the_contract_situation | 签订合同情况 |
|
full_time | 是否全日制师范类专业毕业 |
|
special_professional | 是否受过特教专业培养培训 |
|
special_edu_certificate | 是否有特殊教育从业证书 |
|
it_application_ability | 信息技术应用能力 |
|
free_students | 是否属于免费(公费)师范生 |
|
basic_services | 是否参加基层服务项目 |
|
basic_services_commenced | 参加基层服务项目起始年月 |
|
basic_services_enddate | 参加基层服务项目结束年月 |
|
specialclass_teacher | 是否特级教师 |
|
backbone_teachers | 是否县级及以上骨干教师 |
|
mental_health_teacher | 是否心理健康教育教师 |
|
state_personnel | 人员状态 |
|
working_conditions | 企业工作(实践)时长 |
|
level_of_education | 文化程度 |
|
post_type | 岗位类型 |
|
the_title | 职称 |
|
job_content | 是否“双师型”教师 |
|
professional | 专业 |
|
note | 备注 |
|
new_teachers | 是否新聘教师 |
|
foreign_teachers | 是否交流老师 |
|
is_double | 是否“双师型”教师 |
|
secondaryunit | 所在二级单位 |
|
skill_certificate | 是否具备职业技能等级证书 |
|
audit_status | 审核状态 |
|
emergency_contact_person | 应急联系人 |
|
emergency_contact_ways | 应急联系方式 |
|
join_party_date | 入党时间 |
|
partner_nm | 配偶姓名 |
|
partner_org_nm | 配偶工作单位名称 |
|
children_name1 | 子女姓名1 |
|
children_name2 | 子女姓名2 |
|
children_org_nm1 | 子女工作学习单位名称1 |
|
children_org_nm2 | 子女工作学习单位名称2 |
|
children_name3 | 子女姓名3 |
|
children_name4 | 子女姓名4 |
|
children_org_nm3 | 子女工作学习单位名称3 |
|
children_org_nm4 | 子女工作学习单位名称4 |
|
good_teacher_level | 名师级别 |
|
good_teacher_title | 名师称号 |
|
professional_title | 职称 |
|
backbone_teachers_training_object | 骨干教师培养对象 |
|
job | 专业技术职务 |
|
tech_level | 专业技术等级 |
|
backbone_teacher_level | 骨干教师级别 |
|
subject_leader | 学科带头人 |
|
job_confirm_date | 确认时间(专业技术职务) |
|
at_period | 入编年段 |
|
subject_leader_date | 学科带头人日期 |
|
subject_leader_unit | 学科带头人单位 |
|
backbone_teacher_level_date | 骨干教师级别日期 |
|
backbone_teacher_level_unit | 骨干教师级别单位 |
|
specialclass_teacher_date | 特级教师日期 |
|
specialclass_teacher_unit | 特级教师单位 |
|
good_teacher_level_date | 名师级别日期 |
|
good_teacher_level_unit | 名师级别单位 |
|
good_teacher_title_date | 名师称号日期 |
|
good_teacher_title_unit | 名师称号单位 |
|
professional_title_date | 职称日期 |
|
professional_title_unit | 职称单位 |
|
good_teacher_head | 名师工作领衔 |
|
good_teacher_head_date | 名师工作领衔日期 |
|
good_teacher_head_unit | 名师工作领衔单位 |
|
good_teacher_member | 名师工作室成员 |
|
good_teacher_member_date | 名师工作室成员日期 |
|
good_teacher_member_unit | 名师工作室成员单位 |
|
position_level | 职务层次 |
|
the_contract_date_from | 合同开始日期 |
|
the_contract_date_to | 合同结束日期 |
|
visa_type | 签证类别 |
|
visa_no | 签证号码 |
|
visa_expiring_date | 签证有效期 |
|
engage_time | 聘用期限 |
|
employment_channel | 聘用渠道 |
|
qualification | 是否获得所在国教师资格证书 |
|
obtain_tesol | 是否获得tesol |
|
obtain_tesl | 是否获得tesl |
|
obtain_tefl | 是否获得tefl |
|
foreign_nm | 所在国家 |
|
school_branch | 所在学校分校区 |
|
city_contract_tea_level | 市管合同教师等级 |
|
edu_record | 核定最高学历 |
|
confirm_birthday | 认定出生日期 |
|
confirm_join_party_date | 认定入党时间 |
|
confirm_date_of_employment | 认定参加工作年月 |
|
teaching_assisted_postion | 教辅岗位 |
|
position_statistics | 岗位类别(事业统计) |
|
confirm_include_management_time | 核定纳入名教师管理时间 |
|
confirm_is_include_good_teacher_management | 核定是否纳入名教师管理 |
|
good_class_teacher_level | 名班主任级别 |
|
good_class_teacher_level_date | 名班主任级别确认时间 |
|
good_class_teacher_level_unit | 名班主任级别确认单位 |
|
include_management_time | 纳入名教师管理时间 |
|
partner_telphone | 配偶电话 |
|
学科id | 学科名称 | 学科学段{ |
jcsub01 | 语文 | 0||1||2||4||5 |
jcsub02 | 数学 | 0||1||2||4||5 |
jcsub03 | 英语 | 0||1||2||4||5 |
jcsub13 | 物理 | 1||2||4||5 |
jcsub14 | 化学 | 1||2||4||5 |
jcsub15 | 生物 | 1||2||5 |
jcsub11 | 历史 | 1||2||5 |
jcsub12 | 地理 | 1||2||5 |
jcsub16 | 科学 | 0||1 |
jcsub18 | 美术 | 0||1||2||3||4||5 |
jcsub17 | 艺术 | 0||1||2 |
jcsub20 | 音乐 | 0||1||2||3||4||5 |
jcsub06 | 品德与生活 | 0 |
jcsub07 | 品德与社会 | 0 |
jcsub08 | 思想品德 | 1 |
jcsub09 | 思想政治 | 2||5 |
jcsub19 | 体育与健康 | 0||1||2 |
jcsub21 | 信息技术 | 0||1||2 |
584771665813721088 | 中国历史 | 1 |
584771795690344448 | 世界历史 | 1 |
jcsub22 | 通用技术 | 2 |
jcsub23 | 综合实践活动 | 0||1||2||4||5 |
jcsub24 | 幼教健康 | 3 |
jcsub25 | 幼教科学 | 3 |
jcsub26 | 幼教社会 | 3 |
jcsub27 | 幼教艺术 | 3 |
jcsub28 | 幼教语言 | 3 |
jcsub29 | 科技制作活动 | 0||1 |
jcsub31 | 生活与科技 | 0 |
jcsub30 | 劳动与技术 | 0||1 |
SUB7 | 心理健康教育 | 0||1||2 |
SUB9 | 幼教(学前) | 3 |
SUB20 | 其他 | 5 |
SUB27 | 体育 | 0||1||2 |
SUB28 | 生命教育 | 0 |
SUB35 | 书法 | 0||1||2||4||5||7||8 |
SUB37 | 计算 | 3 |
SUB38 | 计算机 | 5 |
SUB39 | 德育 | 5 |
SUB40 | 数控技术 | 5 |
SUB41 | 电子信息 | 5 |
SUB42 | 光电子技术 | 5 |
SUB43 | 服装设计与工艺 | 5 |
SUB44 | 机械制造 | 5 |
SUB45 | 其它 | 3||5 |
SUB48 | 环境教育 | 0||1 |
SUB49 | 传统文化 | 0||1 |
SUB50 | 安全教育 | 0||1 |
SUB51 | 人生规划 | 1 |
SUB52 | 生命科学 | 2 |
SUB53 | 道德与法治 | 0||1 |
SUB56 | 连锁经营 | 5 |
SUB57 | 信息科技 | 1||2 |
SUB58 | 设计与创作 | 2 |
SUB59 | 写字 | 1 |
SUB60 | 体育与健身 | 0||1||2 |
3ef40ec7f02b4fd8b66da69356ca3923 | 人与社会 | 0||1 |
7cc88a5c42bd42d7ae7a5d93c970974c | 人与自我 | 0||1 |
9a8cf2648dc94f8f904e8241307232fa | 汉语 | 0||1||2 |
dfac74610e57495e84709943e311c4d6 | 生活适应 | 8 |
d7cc9c5fb6034fc6bdcce0a1839362e6 | 生活数学 | 8 |
0abc1f2b88b84aa48dfe4fe42d3d06cc | 中小学安全教育 | 0 |
5352e98927a14b6e84cf6ab1cbedaabb | 写字 毛笔字 | 1 |
2ec954f1fabe49389cf3cacf824b5fdd | 心理健康 | 0||2 |
98832f4a01534ad1b9c64568203882be | 小学生写字 | 0 |
e3ce2c77fa154c929bfb2b769203184a | 生活语文 | 8 |
e56d8408ea55488aa51ea000b2bba7eb | 生命安全教育 | 0||1 |
0841503ef8a24fdb8a5f36a42b84a9af | STEAM创客教育 | 5 |
d79368c3c7cd44e5af4e536866fe1cbf | 中职计算机应用 | 5 |
96136f7adfca4166a8afa0bc08a80472 | 中职机电 | 5 |
91bb6306913842979cf9d63132aa52cc | 中职现代农艺技术 | 5 |
0f7edab0298549a0afbf39ab7e6cbacb | 学前教育 | 5 |
f246abe44e6011ea903b0200f7a542eb | 自然 | 0 |
29c8b5944e6111ea920c0200f7a542eb | 科学与技术 | 0 |
e36138f2524711ea80bf0200f7ebdd04 | 社会 | 1 |
评论
还能输入140字
用户评论
经过核实,本空间由于存在敏感词或非法违规信息或不安全代码或被其他用户举报,
已被管理员(或客服)锁定。
本空间现无法正常访问,也无法进行任何操作。
如需解锁请联系当地教育技术部门,由当地教育技术部门联系锁定人处理。
当前机构空间已被管理员(或客服)封锁。
目前机构空间无法正常访问,也无法进行任何操作。
如需重新开放,请联系当地教育技术部门,由当地教育技术部门联系管理员(或客服)处理。