开放接口API
目录隐藏
- ·一 /users/me.json
- ·1.1 请求URL
- ·1.2 请求方式
- ·1.3 请求参数
- ·1.4 返回结果
- ·二 /users/show.json
- ·2.1 请求URL
- ·2.2 请求方式
- ·2.3 请求参数
- ·2.4 返回结果
- ·三 /enjoy/me.json
- ·3.1 请求URL
- ·3.2 请求方式
- ·3.3 请求参数
- ·3.4 返回结果
- ·四 /resource/downloadadd.json
- ·4.1 请求URL
- ·4.2 请求方式
- ·4.3 请求参数
- ·4.4 返回结果
- ·五 /school/show.json
- ·5.1 请求URL
- ·5.2 请求方式
- ·5.3 请求参数
- ·5.4 返回结果
- ·六 /classes/show.json
- ·6.1 请求URL
- ·6.2 请求方式
- ·6.3 请求参数
- ·6.4 返回结果
- ·七 /classes/showmore.json
- ·7.1 说明
- ·7.2 请求URL
- ·7.3 请求方式
- ·7.4 请求参数
- ·7.5 返回结果
- ·八 /users/showteacher.json
- ·8.1 说明
- ·8.2 请求URL
- ·8.3 请求方式
- ·8.4 请求参数
- ·8.5 返回结果
一 /users/me.json
获取当前登录用户的资料。
1.1 请求URL
1.2 请求方式
GET
1.3 请求参数
| 参数名 | 必选 | 介绍 |
| consumerKey | true | APIKey(由开放平台颁发给第三方系统或应用)； |
| token | true | Access Token |
| sign | true | 签名值，密钥为：Access Secret，Access Secret由用户台颁发给第三方系统或应用 ； |
| timeTamp | true | 时间戳，其值是距1970 00:00:00 GMT的秒数，必须是大于0的整数，与服务器时间间隔不能超过10分钟； |
| field | false | 默认情况下接口仅返回基础字段，您可以通过配置该参数来返回自定义字段，可选值为phase、district、school、class，分别代表教师、学生、学校的学段信息、用户所在的行政区划、学校详情，教师或学生的班级信息，多个字段用英文半角逗号分开； |
1.4 返回结果
结果格式：JSON
结果说明：
| 字段名 | 字段类型 | 说明 |
| uid | string(36) | 当前登录用户ID，作为云平台用户与第三方用户的唯一映射； |
| name | string | 姓名 |
| userName | string | 用户名 |
| sex | Number(1) | 性别 0表示男，1表示女； |
| userType | Number | 用户类型值： 1: 教师 2: 学校管理员 3: 区县管理员 4: 市级管理员 5: 省级管理员 6: 系统管理员 7: 学生 8: 开发者 9: 家长 10: 专家 |
| userTypeName | string | 用户类型名，为userType与userTypeKey的释义； |
| userTypeKey | string | 用户类型标识： Teacher: 教师 School: 学校管理员 County: 区县管理员 City: 市级管理员 Province: 省级管理员 Admin: 系统管理员 Student: 学生 Developer: 开发者 Parents: 家长 ActiveExpert: 专家 |
| nation | string | 民族 |
| birthday | Datetime | 生日 |
| face30 | string | 30*30头像的地址 |
| face80 | string | 80*80头像的地址 |
| face100 | string | 100*100头像的地址 |
| remark | string | 备注 |
| lastLoginDate | Datetime | 最后登录时间 |
| lastActiveDate | Datetime | 最后活动时间 |
| phase | Object Array | 传参的时候需要配置field传入phase才可以返回该数据，表示教师、学生、学校管理员的学段，其他类型的用户此字段为空； |
| district | Object | 传参的时候需要配置field传入district才可以返回该数据，表示用户所在性质区划结构，非教师、学生、学校管理员、省管理员、市管理员、区县管理员类型用户此字段均为空； |
| school | Object | 传参的时候需要配置field传入school才可以返回该数据，表示教师、学生、学校管理员的学校信息，其他类型的用户此字段为空； |
class | Object Array | 传参的时候需要配置field传入class才可以返回该数据，表示教师、学生加入的班级信息，其他类型的用户array长度为0； |
返回样例：
{
"uid": "889642247672152284184002627107191313", //用户ID
"userType": 1, //用户类型值
"userTypeKey": "Teacher",//用户类型标识
"userTypeName": "教师",
"userName": "ruchao26", //用户名
"name": "茹超",//用户姓名
"face30": "http://go.hengqian.net/UploadFiles/Face/2016/Avatar_e6c0b5b728a4cd3dfca29726d6509cdc_3.jpg",//用户头像30*30
"face80": "http://go.hengqian.net/UploadFiles/Face/2016/Avatar_e6c0b5b728a4cd3dfca29726d6509cdc_2.jpg",//用户头像80*80
"face100": "http://go.hengqian.net/UploadFiles/Face/2016/Avatar_e6c0b5b728a4cd3dfca29726d6509cdc_1.jpg",//用户头像100*100
"nation": "汉",//用户民族
"sex": 0,//性别
"birthday": "1980-01-01T00:00:00",//生日
"remark": "", //教师
"lastActiveDate": "2016-06-07T11:36:10",//用户最后一次活动时间
"lastLoginDate": "2016-06-07T11:37:24",//用户最后一次登录时间
//用户学段信息
"phase": [
{
"pKey": "Junior", //学段类型标识
"pid": "2", //学段类型值
"pName": "初中" //学段类型名
}
],
//用户学校信息
"school": {
"linkName": "恒谦教育", //联系人
"url": "http://www.hengqian.com", //网站地址
"remark": "西安恒谦教育科技股份有限公司", //介绍
"sid": "DC25A0B9-BDD5-4460-AF67-F2A78C849E8F", //学校ID
"name": "恒谦中学", //名称
//学校所在行政区划
"district": {
"ProvinceID": "610000",//省级行政区划码
"ProvinceName": "陕西省",//省级行政区划名称
"CityID": "610100",//市级行政区划码
"CityName": "西安市",//市级行政区划名称
"CountyID": "610112",//区县级行政区划码
"CountyName": "未央区",//区县级行政区划名称
"DisStar": 2 //所在行政区划级别，0为省级 1为市级 2为区县级
},
"photo": "http://go.hengqian.net/UploadFiles/SchoolImg/2016/03/9e4d6b700b8757277308d23adbccec22.jpg", //学校形象图片地址
"address": "御道华城A座10层",//学校所在地址
//学校包含学段
"phase": [
{
"pKey": "Primary",
"pid": "1",
"pName": "小学"
},
{
"pKey": "Junior",
"pid": "2",
"pName": "初中"
},
{
"pKey": "High",
"pid": "3",
"pName": "高中"
},
{
"pKey": "Preschool",
"pid": "4",
"pName": "幼教"
}
],
"teacherNum": 274
},
//用户所在行政区划
"district": {
"ProvinceID": "610000",
"ProvinceName": "陕西省",
"CityID": "610100",
"CityName": "西安市",
"CountyID": "610112",
"CountyName": "未央区",
"DisStar": 2
},
//班级信息
"class": [
{
"starYear": "2011",//入学年份
"cName": "二年级2班",//班级名称
"cid": "33725807-2a3e-47bd-9466-92a21289146d",//班级ID
"subjectID": 2,//如果为教师，所带科目ID
"memberTypeKey": "Master",//在该班的身份类型标识
"memberTypeName": "班主任",//在该班的身份类型名称
"gradeCode": "105",//该班所在年级ID
"studentNum": 0,//该班级学生人数
"gradeName": "二年级",//该班所在年级名称
"memberType": 1, //在该班的身份类型值
"classCode": "202",//该班所在班级编号ID
"subjectName": "数学",//如果为教师，所带科目名称
"teacherNum": 1,//该班级教师人数
"className": "2班" //该班所在班级编号名称
}
]
}二 /users/show.json
获取一组用户的资料，最多可返回50个用户。
2.1 请求URL
2.2 请求方式
GET
2.3 请求参数
参数名 | 必选 | 介绍 |
| consumerKey | true | APIKey(由开放平台颁发给第三方系统或应用) |
| uids | true | 用户id列表，多个id用英文半角逗号分开 |
| sign | true | 签名值，密钥为：secretKey，secretKey由开放平台颁发给第三方系统或应用 |
| timeTamp | true | 时间戳，其值是距1970 00:00:00 GMT的秒数，必须是大于0的整数，与服务器时间间隔不能超过10分钟 |
| field | false | 默认情况下接口仅返回基础字段，您可以通过配置该参数来返回自定义字段，可选值为phase、district、school、class，分别代表教师、学生；学校的学段信息、用户所在的行政区划、学校详情，教师跟学生的班级信息，多个字段用英文半角逗号分开。 |
2.4 返回结果
结果格式：JSON
结果说明：Object Array
| 字段名 | 字段类型 | 说明 |
| uid | string(36) | 当前登录用户ID，作为云平台用户与第三方用户的唯一映射； |
| name | string | 姓名 |
| userName | string | 用户名 |
| sex | Number(1) | 性别 0表示男，1表示女 |
| userType | Number | 用户类型值： 1: 教师 2: 学校管理员 3: 区县管理员 4: 市级管理员 5: 省级管理员 6: 系统管理员 7: 学生 8: 开发者 9: 家长 10: 专家 |
| userTypeName | string | 用户类型名，为userType与userTypeKey的释义； |
| userTypeKey | string | 用户类型标识：Teacher: 教师 School: 学校管理员 County: 区县管理员 City: 市级管理员 Province: 省级管理员 Admin: 系统管理员 Student: 学生 Developer: 开发者 Parents: 家长 ActiveExpert: 专家 |
| nation | string | 民族 |
| birthday | Datetime | 生日 |
| face30 | string | 30*30头像的地址 |
| face80 | string | 80*80头像的地址 |
| face100 | string | 100*100头像的地址 |
remark | string | 备注 |
| lastLoginDate | Datetime | 最后登录时间 |
lastActiveDate | Datetime | 最后活动时间 |
| phase | Object Array | 传参的时候需要配置field传入phase才可以返回该数据，表示教师、学生、学校管理员的学段，其他类型的用户此字段为空； |
| district | Object | 传参的时候需要配置field传入district才可以返回该数据，表示用户所在性质区划结构，非教师、学生、学校管理员、省管理员、市管理员、区县管理员类型用户此字段均为空； |
| school | Object | Object传参的时候需要配置field传入school才可以返回该数据，表示教师、学生、学校管理员的学校信息，其他类型的用户此字段为空； |
| class | Object Array | 传参的时候需要配置field传入class才可以返回该数据，表示教师、学生加入的班级信息，其他类型的用户array长度为0。 |
返回样例：
[
{
"remark": "",
"userType": 1,
"userName": "ruchao26",
"phase": [
{
"pKey": "Junior",
"pid": "2",
"pName": "初中"
}
],
"school": {
"linkName": "恒谦教育",
"url": "http://www.hengqian.com",
"remark": "西安恒谦教育科技股份有限公司",
"sid": "DC25A0B9-BDD5-4460-AF67-F2A78C849E8F",
"name": "恒谦中学",
"district": {
"ProvinceID": "610000",
"ProvinceName": "陕西省",
"CityID": "610100",
"CityName": "西安市",
"CountyID": "610112",
"CountyName": "未央区",
"DisStar": 2
},
"photo": "http://go.hengqian.net/UploadFiles/SchoolImg/2016/03/9e4d6b700b8757277308d23adbccec22.jpg",
"address": "御道华城A座10层",
"phase": [
{
"pKey": "Primary",
"pid": "1",
"pName": "小学"
},
{
"pKey": "Junior",
"pid": "2",
"pName": "初中"
},
{
"pKey": "High",
"pid": "3",
"pName": "高中"
},
{
"pKey": "Preschool",
"pid": "4",
"pName": "幼教"
}
],
"teacherNum": 274
},
"name": "茹超",
"district": {
"ProvinceID": "610000",
"ProvinceName": "陕西省",
"CityID": "610100",
"CityName": "西安市",
"CountyID": "610112",
"CountyName": "未央区",
"DisStar": 2
},
"face100": "http://go.hengqian.net/UploadFiles/Face/2016/Avatar_e6c0b5b728a4cd3dfca29726d6509cdc_1.jpg",
"nation": "汉",
"face80": "http://go.hengqian.net/UploadFiles/Face/2016/Avatar_e6c0b5b728a4cd3dfca29726d6509cdc_2.jpg",
"lastActiveDate": "2016-06-07T11:37:24",
"userTypeKey": "Teacher",
"class": [
{
"starYear": "2011",
"cName": "二年级2班",
"cid": "33725807-2a3e-47bd-9466-92a21289146d",
"subjectID": 2,
"memberTypeKey": "Master",
"memberTypeName": "班主任",
"gradeCode": "105",
"studentNum": 0,
"gradeName": "二年级",
"memberType": 1,
"classCode": "202",
"subjectName": "数学",
"teacherNum": 1,
"className": "2班"
}
],
"lastLoginDate": "2016-06-07T14:48:34",
"face30": "http://go.hengqian.net/UploadFiles/Face/2016/Avatar_e6c0b5b728a4cd3dfca29726d6509cdc_3.jpg",
"sex": 0,
"userTypeName": "教师",
"birthday": "1980-01-01T00:00:00",
"uid": "889642247672152284184002627107191313"
}
]三 /enjoy/me.json
获取当前登录用户的教学属性设置，教学属性是指用户设置的学科、年级、版本信息。
3.1 请求URL
3.2 请求方式
GET
3.3 请求参数
| 参数名 | 必选 | 介绍 |
| consumerKey | true | APIKey(由开放平台颁发给第三方系统或应用)； |
| token | true | Access Token |
| sign | true | 签名值，密钥为：Access Secret，Access Secret由用户台颁发给第三方系统或应用； |
timeTamp | true | 时间戳，其值是距1970 00:00:00 GMT的秒数，必须是大于0的整数，与服务器时间间隔不能超过10分钟； |
3.4 返回结果
结果格式：JSON
结果说明：Object Array
| 字段名 | 字段类型 | 说明 |
| Name | string | 教学属性名称 |
| ID | string | 教学属性ID |
| IsDefault | bool | 是否默认教学属性 |
| SubjectName | string | 教学属性中的学科名称 |
| SubjectID | Number | 教学属性中的学科ID |
| VersionName | string | 教学属性中的教材版本名称 |
| VersionID | Number | 教学属性中的教材版本ID |
| GradeName | string | 教学属性中的年级名称 |
| GradeID | Number | 年级ID |
| Phase | Number | 教学属性的学段 |
返回样例：
[
{
"GradeID": 27,
"Name": "数学/六年级/西师大版",
"ID": "2892a889-b73a-45e8-9d6e-8fbbfcf6fc1c",
"IsDefault": true,
"SubjectName": "数学",
"SubjectID": 2,
"VersionName": "西师大版",
"VersionID": 119,
"GradeName": "六年级",
"Phase": "1"
},
{
"GradeID": 22,
"Name": "数学/一年级/西师大版",
"ID": "15907f21-7fc4-44cc-acda-dff03584e215",
"IsDefault": false,
"SubjectName": "数学",
"SubjectID": 2,
"VersionName": "西师大版",
"VersionID": 119,
"GradeName": "一年级",
"Phase": "1"
},
{
"GradeID": 23,
"Name": "语文/二年级/人教新课标",
"ID": "60c6de0b-13e5-47e3-9254-a4c04024c501",
"IsDefault": false,
"SubjectName": "语文",
"SubjectID": 1,
"VersionName": "人教新课标",
"VersionID": 75,
"GradeName": "二年级",
"Phase": "1"
},
{
"GradeID": 29,
"Name": "语文/七年级/人教新课标",
"ID": "3400a501-1937-4bbe-b850-19fdcec350ac",
"IsDefault": false,
"SubjectName": "语文",
"SubjectID": 1,
"VersionName": "人教新课标",
"VersionID": 75,
"GradeName": "七年级",
"Phase": "2"
}
]四 /resource/downloadadd.json
写入当前用户下载记录，此接口主要用于资源类应用接入，当用户下载的时候将下载记录写入，注：此接口需要用户等级为合作开发者才可以调用，如果需要请单独申请！
4.1 请求URL
4.2 请求方式
GET
4.3 请求参数
参数名 | 必选 | 介绍 |
| consumerKey | true | APIKey(由开放平台颁发给第三方系统或应用) |
| token | true | Access Token |
| sign | true | 签名值，密钥为：Access Secret，Access Secret由用户台颁发给第三方系统或应用 |
| timeTamp | true | 时间戳，其值是距1970 00:00:00 GMT的秒数，必须是大于0的整数，与服务器时间间隔不能超过10分钟 |
| rID | true | 资源ID，此ID为第三方系统中资源的ID，云平台会通过此ID向第三方接口发送请求来获取该资源的详情 |
| fromType | true | 资源的来源标识，注：该标识需要第三方向恒谦云平台申请 |
4.4 返回结果
结果格式：JSON
写入成功：
{"request":"/openapi/resource/downloadadd.json","error_code":"60000","error":"数据写入成功"}五 /school/show.json
获取多个学校的信息，最多允许50个。
5.1 请求URL
5.2 请求方式
GET
5.3 请求参数
参数名 | 必选 | 介绍 |
| consumerKey | true | APIKey(由开放平台颁发给第三方系统或应用)； |
| sids | true | 学校ID，多个ID用英文班级逗号分开； |
| sign | true | 签名值，密钥为：secretKey，secretKey由开放平台颁发给第三方系统或应用； |
| timeTamp | true | 时间戳，其值是距1970 00:00:00 GMT的秒数，必须是大于0的整数，与服务器时间间隔不能超过10分钟； |
| field | false | 默认情况下接口仅返回基础字段，您可以通过配置该参数来返回自定义字段，可选值为manager，代表返回该学校管理员的信息。 |
5.4 返回结果
结果格式：JSON
结果说明：Object Array
| 字段名 | 字段类型 | 说明 |
| sid | string | 学校ID |
| name | string | 学校名称 |
| phase | Object Array | 学校学段信息 |
| linkName | string | 联系人 |
| address | string | 学校地址 |
| url | string | 学校网站地址 |
| photo | string | 学校形象照片地址 |
| remark | string | 学校介绍 |
teacherNum | Number | 学校教师人数 |
| district | Object | 学校所在地区行政区划信息 |
| manager | Object | 传参的时候需要配置field传入manager才可以返回该数据，代表该学校管理员的信息，未找到管理员信息则返回空。 |
返回样例：
[
{
"linkName": "恒谦教育",
"manager": {
"nation": "",
"face100": "http://go.hengqian.net/UploadFiles/Face/2016/Avatar_1ea91d6d2ec7800d268224cf4bcde100_1.jpg",
"lastLoginDate": "2016-06-06T11:24:25",
"face30": "http://go.hengqian.net/UploadFiles/Face/2016/Avatar_1ea91d6d2ec7800d268224cf4bcde100_3.jpg",
"remark": "",
"lastActiveDate": "2016-06-06T11:21:31",
"name": "恒谦教育",
"uid": "828332032760537464051061662477819258",
"sex": 0,
"userName": "hq",
"birthday": "1980-01-01T00:00:00",
"face80": "http://go.hengqian.net/UploadFiles/Face/2016/Avatar_1ea91d6d2ec7800d268224cf4bcde100_2.jpg"
},
"url": "http://www.hengqian.com",
"remark": "西安恒谦教育科技股份有限公司",
"sid": "DC25A0B9-BDD5-4460-AF67-F2A78C849E8F",
"name": "恒谦中学",
"district": {
"ProvinceID": "610000",
"ProvinceName": "陕西省",
"CityID": "610100",
"CityName": "西安市",
"CountyID": "610112",
"CountyName": "未央区",
"DisStar": 2
},
"photo": "http://go.hengqian.net/UploadFiles/SchoolImg/2016/03/9e4d6b700b8757277308d23adbccec22.jpg",
"address": "御道华城A座10层",
"phase": [
{
"pKey": "Primary",
"pid": "1",
"pName": "小学"
},
{
"pKey": "Junior",
"pid": "2",
"pName": "初中"
},
{
"pKey": "High",
"pid": "3",
"pName": "高中"
},
{
"pKey": "Preschool",
"pid": "4",
"pName": "幼教"
}
],
"teacherNum": 274
}
]六 /classes/show.json
获取某个班级的信息。
6.1 请求URL
6.2 请求方式
GET
6.3 请求参数
参数名 | 必选 | 介绍 |
| consumerKey | true | APIKey(由开放平台颁发给第三方系统或应用) |
| cid | true | 班级ID |
| sign | true | 签名值，密钥为：secretKey，secretKey由开放平台颁发给第三方系统或应用 |
| timeTamp | true | 时间戳，其值是距1970 00:00:00 GMT的秒数，必须是大于0的整数，与服务器时间间隔不能超过10分钟 |
| field | false | 默认情况下接口仅返回基础字段，您可以通过配置该参数来返回自定义字段，可选值为member，代表返回该班级的班级成员（学生、教师） |
6.4 返回结果
结果格式：JSON 或空(未找到指定的班级)
结果说明：Object
| 字段名 | 字段类型 | 说明 |
| cid | string | 班级ID |
| cName | string | 班级名称 |
| gradeCode | Number | 班级所在的年级ID |
| gradeName | string | 班级所在的年级名称 |
| classCode | Number | 该班所在班级编号ID |
| className | string | 该班所在班级编号名称 |
| teacherNum | Number | 教师人数 |
| studentNum | Number | 学生人数 |
| starYear | Number | 入学年份 |
| member | Object Array | 传参的时候需要配置field传入member才可以返回该数据，表示该班级的成员 |
返回样例：
{
"starYear": 2011, //入学年份
"cName": "二年级2班", //班级名称
"cid": "33725807-2a3e-47bd-9466-92a21289146d", //班级ID
//成员
"member": [
{
"memberTypeName": "班主任", //成员类型名称
"subjectID": 2, //如果是教师则该成员所带科目ID
"memberTypeKey": "Master", //成员类型标识
"name": "茹超", //成员姓名
"uid": "889642247672152284184002627107191313", //成员ID
"memberType": 1, //成员类型值
"userName": "ruchao26", //成员用户名
"subjectName": "数学" //如果是教师则该成员所带科目名称
}
],
"gradeCode": "105", //班级所在的年级ID
"studentNum": 0,//学生人数
"gradeName": "二年级",//班级所在的年级名称
"classCode": "202",//该班所在班级编号ID
"teacherNum": 1,//教师人数
"className": "2班" //该班所在班级编号名称
}七 /classes/showmore.json
7.1 说明
获取某个学校所有班级的信息。注：此接口需要用户等级为高级开发者才可以调用，如果需要请单独申请！
7.2 请求URL
7.3 请求方式
GET
7.4 请求参数
| 参数名 | 必选 | 介绍 |
| consumerKey | true | APIKey(由开放平台颁发给第三方系统或应用) |
| sid | true | 学校ID |
| sign | true | 签名值，密钥为：secretKey，secretKey由开放平台颁发给第三方系统或应用 |
| field | false | 默认情况下接口仅返回班级ID字段(cid)，您可以通过配置该参数来返回自定义字段，可选值为more，代表返回该班级的详细信息 |
| timeTamp | true | 时间戳，其值是距1970 00:00:00 GMT的秒数，必须是大于0的整数，与服务器时间间隔不能超过10分钟 |
7.5 返回结果
结果格式：JSON
结果说明：Object Array
| 字段名 | 字段类型 | 说明 |
| cid | string | 班级ID |
| cName | string | 班级名称 |
| gradeCode | Number | 班级所在的年级ID |
| gradeName | string | 班级所在的年级名称 |
| classCode | Number | 该班所在班级编号ID |
| className | string | 该班所在班级编号名称 |
| teacherNum | Number | 教师人数 |
| studentNum | Number | 学生人数 |
| starYear | Number | 入学年份 |
返回样例：
[{
"starYear": 2011, //入学年份
"cName": "二年级2班", //班级名称
"cid": "33725807-2a3e-47bd-9466-92a21289146d", //班级ID
"gradeCode": "105", //班级所在的年级ID
"studentNum": 0,//学生人数
"gradeName": "二年级",//班级所在的年级名称
"classCode": "202",//该班所在班级编号ID
"teacherNum": 1,//教师人数
"className": "2班" //该班所在班级编号名称
}]
八 /users/showteacher.json
8.1 说明
获取某个学校所有教师的信息。注：此接口需要用户等级为高级开发者才可以调用，如果需要请单独申请！
8.2 请求URL
8.3 请求方式
GET
8.4 请求参数
| 参数名 | 必选 | 介绍 |
| consumerKey | true | APIKey(由开放平台颁发给第三方系统或应用) |
| sid | true | 学校ID |
| sign | true | 签名值，密钥为：secretKey，secretKey由开放平台颁发给第三方系统或应用 |
| timeTamp | true | 时间戳，其值是距1970 00:00:00 GMT的秒数，必须是大于0的整数，与服务器时间间隔不能超过10分钟 |
| field | false | 默认情况下接口仅返回教师ID字段(uid)，您可以通过配置该参数来返回自定义字段，可选值为infos, phase, class，代表返回该教师的详细信息,学段,班级，我们不建议一次返回过多的数据，建议仅通过此接口返回教师的uid，然后通过uid来访问 /users/show.json接口来获取该教师的详细信息 |
8.5 返回结果
结果格式：JSON
结果说明：Object Array
| 字段名 | 字段类型 | 说明 |
| uid | Number(36) | 当前登录用户ID，作为云平台用户与第三方用户的唯一映射 |
| name | string | 姓名，需配置field =infos |
| userName | string | 用户名，需配置field =infos |
| sex | Number(1) | 性别 0表示男，1表示女，需配置field =infos |
| nation | string | 民族，需配置field =infos |
| birthday | Datetime | 生日，需配置field =infos |
| face30 | string | 30*30头像的地址，需配置field =infos |
| face80 | string | 80*80头像的地址，需配置field =infos |
| face100 | string | 100*100头像的地址，需配置field =infos |
| remark | string | 备注，需配置field =infos |
| lastLoginDate | Datetime | 最后登录时间，需配置field =infos |
| lastActiveDate | Datetime | 最后活动时间，需配置field =infos |
| phase | Object Array | 传参的时候需要配置field传入phase才可以返回该数据，表示教师的学段 |
| class | Object Array | 传参的时候需要配置field传入class才可以返回该数据，表示教师的班级信息 |
返回样例：
[{
"lastActiveDate": "2016-10-08 09:58:20",
"phase": [
{
"pName": "初中",
"pKey": "Junior",
"pid": "2"
}
],
"birthday": "1977-06-15",
"remark": "",
"lastLoginDate": "2016-10-09 11:22:41",
"name": "测试用户",
"face100": "http://go.hengqian.net/UploadFiles/Face/2016/Avatar_f9c1fcae0a211287ff69e751662c3c6b_1.jpg",
"sex": 0,
"face80": "http://go.hengqian.net/UploadFiles/Face/2016/Avatar_f9c1fcae0a211287ff69e751662c3c6b_2.jpg",
"uid": "078732273016932637121178086507620182",
"userName": "hqjy310",
"face30": "http://go.hengqian.net/UploadFiles/Face/2016/Avatar_f9c1fcae0a211287ff69e751662c3c6b_3.jpg",
"class": [
{
"cid": "253417e7-a0ea-4183-a84d-fdd39768e45c",
"subjectID": 290,
"gradeName": "六年级",
"memberTypeName": "任课教师",
"className": "1班",
"classCode": "201",
"cName": "六年级1班",
"subjectName": "社会",
"gradeCode": "109",
"memberType": 2,
"teacherNum": 6,
"studentNum": 3,
"starYear": 2010,
"memberTypeKey": "Teacher"
}
],
"nation": "汉"}]