习网第三方用户对接方案V1.0

关于第三方用户与习网用户对接方案

深圳习习网络科技有限公司

版权所有不得复制

一、文档说明

1、为了更好更快的将第三方用户接入习网，使用习网各类应用，而编写此文档。

二、对接方式

1、与第三方对接用户数据。

第三方提供OAuth2.0认证授权协议，通过获取第三方用户OpenId（或用户详细信息），生成或绑定习网用户，跳转习网应用。

2、与第三方对接用户班级信息。

第三方需要与习网用户的班级信息对接，第三方必须提供按照习网数据标准提供以用户班级信息接口。

（1）、习网学段年级数据标准:

学段名称学段ID年级名称年级ID备注

小学1001一年级1101二年级1102三年级1103四年级1104五年级1105六年级1106

初中1003一年级1107二年级1108三年级1109

高中1005一年级1111二年级1112三年级1113

幼儿1009

小班1114中班1115大班1116学前班1117

大学1007一年级1118二年级1119三年级1120四年级1121

（2）、数据接口

接口名称:获取用户班级信息接口

接口地址：由第三方提供.

请求方式：GET

入参：

参数名必选类型及范围说明

access_token是string 访问令牌

返回结果：

返回值字段字段类型说明

user_id string用户id

user_name string用户姓名

real_name string用户昵称

school_name string学校名称

role_code int角色id（0：无1：学生2：老师4：家长）

area_code int学校地区编码（区或县）例：广东省深圳市宝安区440306 period_id int学段Id（习网学段）参照习网学段年级数据标准

grade_id int年级Id（习网年级）参照习网学段年级数据标准

class_id int班级序号（习网班级序号1-60，第三方根据班级编号自定义规则提

供序号即可）