Skip to content
fundawang edited this page Apr 15, 2013 · 10 revisions

调用地址

/simpleoauth?op=score&subop=eids&access_token=ACCESS_TOKEN&sid=SID&sign=SIGN

获得成绩中的考试科目清单

/simpleoauth?op=score&subop=geteid&access_token=ACCESS_TOKEN&sid=SID&eid=EID&sign=SIGN

获得成绩中指定科目的成绩

调用顺序

第三方应用应该先调用eids接口获得系统可提供的所有成绩科目清单,解析后再调用geteid接口获得相应科目的成绩。

输入

  • ACCESS_TOKEN:通过 [grant_access](获取授权Grant Access) 获取到的 access_token。
  • SID:我院准考证号,形如“2013BXXXX”。
  • EID:考试科目ID
  • SIGN:将所有输入内容(此接口为ACCESS_TOKEN,SID,EID)与APPKEY混合后进行的MD5摘要字符串。

输出

eids 接口

SIGN验证成功时,返回 HTTP 200/OK,并输出 json 字符串,类似以下的结果: {"status":"0","sid":"2013BXXXX","exams":[{"eid":"303","ename":"听写C"},{"eid":"313","ename":"视唱C"}, {"eid":"323","ename":"视唱练耳C"},{"eid":"350","ename":"乐理"}],"sign":"781e8d09cb24426b11be933965a1b52a"}

注意:输出结果均为 UTF-8 编码,请使用GB编码的第三方应用自行进行编码转换

  • status:接口内容状态。0 为调用成功。
  • sid:输入的我院准考证号,原样返回。
  • exams:目前系统提供的考试科目ID与科目名称数组。

第三方应用可以根据科目ID与科目名称的对应关系,自行选择相应的科目ID,然后再调用 geteid 接口获得相应科目的成绩。

geteid 接口

SIGN验证成功时,返回 HTTP 200/OK,并输出 json 字符串,类似以下的结果: {"status":"0","sid":"2013BXXXX","eid":"350","ename":"乐理","score":"65","sign":"b966a58a196cb943b09a865c34017fcc"}

注意:输出结果均为 UTF-8 编码,请使用GB编码的第三方应用自行进行编码转换

  • status:接口内容状态。0 为调用成功。
  • sid:输入的我院准考证号,原样返回。
  • eid:输入的考试科目ID,原样返回。
  • ename:与科目ID对应的科目名称。
  • score:相应科目的成绩。

输出报错

输入的参数个数不对,缺少必要的参数

返回 HTTP 200/OK,并输出 json 字符串,类似以下的结果: {"status":"40002","errmsg":"score 操作的输入无效。","sign":"c814642ed9e2069227034b648506bb0d"}

考生尚未与第三方应用连接

返回 HTTP 200/OK,并输出 json 字符串,类似以下的结果: {"status":"40003","errmsg":"2013BXXX 尚未与第三方应用连接。","sign":"e4ecae87a79b7675a7c1d4ec7da967b6"}

输入的结果查询不到对应的数据

返回 HTTP 200/OK,并输出 json 字符串,类似以下的结果: {"status":"40020","errmsg":"没有与 2013B2131 相关的考试科目。","sign":"40df15189107e7795cd4c731b133ac04"}