【龙岩市教育数据共享服务平台】
天喻账号信息接口
（版本号 V1.0）
文档修订记录
版本号 | 状态 | 简要说明 | 日期 | 变更人 |
V1.0 | 建立 | 天喻账号信息接口 | 2022.3.31 | 童倩 |
V1.1 | 新增 | 新增学生家长信息接口 | 2022.4.15 | 童倩 |
龙岩市教育数据共享服务平台在政务信息网和政务外网、互联网区提供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/userInfo/getUserById | |||||
接口方式 | HTTP | 提交方式 | get | |||
入参 | 名称 | 必填 | 数据类型 | 说明 | ||
user_id | 否 | string | 天喻用户id | |||
出参 | 名称 | 数据类型 | 说明 | |||
errCode | String | 结果编码,000000：成功 | ||||
message | String | 结果描述 | ||||
请求示例 | user_id=xxx
| |||||
返回示例 | {{ "errCode": "000000", "msg": "Successed", "data": { "totalNum": 1, "currentPage": 1, "records": [{ "card_code": "", "birthdate": 1639393585, "gender": true, "area_code": "350825", "city_code": "350800", "avatar": "", "province_code": "350000", "card_type": false, "user_type": "0", "phone": "", "user_id": "0002d799b08b4d25976c0ee0de4762c3", "nick_name": "杨庆锋", "name": "杨庆锋", "account": "yangqingfeng7113" }] } }} | |||||
返回说明 | 序号 | 字段 | 说明 | |||
1 | user_id | 用户ID | ||||
2 | card_type | 身份证类型 | ||||
3 | card_code | 身份证号 | ||||
4 | name | 用户姓名 | ||||
5 | gender | 性别 | ||||
6 | phone | 电话 | ||||
7 | account | 账号 | ||||
| 8 | avatar | 头像 | |||
| 9 | user_type | 用户类型。 | |||
| 10 | nick_name | 昵称 | |||
| 11 | city_code | 所在市编号 | |||
| 12 | province_code | 所在省编号 | |||
| 13 | area_code | 所在区编号 | |||
| 14 | birthdate | 生日 | |||
接口访问地址 | http://open-api.longyanedu.net//sutFamily/getList | |||||
接口方式 | HTTP | 提交方式 | get | |||
入参 | 名称 | 必填 | 数据类型 | 说明 | ||
org_code | 是 | string | 学校标识码 | |||
stu_name | 否 | string | 学生姓名 | |||
stu_card | 否 | string | 学生身份证 | |||
update_time | 否 | string | 起始时间，格式为yyyymmddhhmmss | |||
出参 | 名称 | 数据类型 | 说明 | |||
errCode | String | 结果编码,000000：成功 | ||||
message | String | 结果描述 | ||||
请求示例 | org_code=2135008070&stu_name=丘梦烨&stu_card=350821200910021540 | |||||
返回示例 | { "errCode": "000000", "msg": "Successed", "data": { "totalNum": 2, "currentPage": 1, "records": [{ "stu_card": "350821200910021540", "phone": "", "stu_name": "丘梦烨", "relation_type": 1, "org_name": "长汀县新桥廖家小学", "relation_name": "丘梦烨的妈妈", "org_code": "2135008070" }, { "stu_card": "350821200910021540", "phone": "", "stu_name": "丘梦烨", "relation_type": 2, "org_name": "长汀县新桥廖家小学", "relation_name": "丘梦烨的爸爸", "org_code": "2135008070" }] } } | |||||
返回说明 | 序号 | 字段 | 说明 | |||
1 | stu_card | 学生身份证 | ||||
2 | org_name | 学校名称 | ||||
3 | relation_name | 家长 | ||||
4 | relation_type | 关系类型。1:妈妈, 2:爸爸, 3:奶奶, 4:爷爷, 5:外婆, 6:外公, 7:小姨, 8:舅舅, 9:叔叔, 10:伯伯, 11:姑姑, 12:姑父 | ||||
5 | org_code | 学校标识码 | ||||
6 | stu_name | 学生姓名 | ||||
7 | phone | 家长手机号 | ||||
评论
还能输入140字
用户评论
经过核实，本空间由于存在敏感词或非法违规信息或不安全代码或被其他用户举报，
已被管理员（或客服）锁定。
本空间现无法正常访问，也无法进行任何操作。
如需解锁请联系当地教育技术部门，由当地教育技术部门联系锁定人处理。
当前机构空间已被管理员（或客服）封锁。
目前机构空间无法正常访问，也无法进行任何操作。
如需重新开放，请联系当地教育技术部门，由当地教育技术部门联系管理员（或客服）处理。
龙岩市教育公共服务平台