Skip to content

获得报名状况Signup

fundawang edited this page Mar 21, 2013 · 20 revisions

调用地址

/simpleoauth?op=signup&access_token=ACCESS_TOKEN&sid=SID&idcard_number=IDCARDNUM&sign=SIGN

输入

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

输出

接口调用成功,存在此考生时

SIGN验证成功时,返回 HTTP 200/OK,并输出 json 字符串,类似以下的结果:

{"status":"0", "sid":"2013BXXXX", "name":"张三", "idcard_number":"140203xxxxxxx, "validated":"1", "pass_round1":"0", "pass_round3":"0", "pid":"D102", "dname":"作曲系", "pname":"作曲", "sign":"fa454fb784d1ca9d1fc938f052113936"}

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

  • status:接口内容状态。0 为调用成功。
  • sid:输入的我院准考证号,原样返回。
  • name:考生姓名。以供第三方应用进行比对验证。
  • idcard_number:输入的身份证号码,原样返回。
  • validated:0 代表仅报名但未参加考试,1 代表已缴费并参加了我院初试。
  • pass_round1:0 代表未进入复试,1 代表进入了复试。
  • pass_round3:0 代表我院未发放考试合格证,1 代表我院为其发放了备取合格证,10 代表我院为其发放了正取合格证。
  • pid:我院招生系统中的专业代号。
  • dname:报考我院系部。
  • pname:报考我院专业。
  • sign:将所有输出内容与 APPKEY 混合后生成的 MD5 摘要字符串。第三方应用应该使用同样的算法来验证输出是否可靠。

第三方应用应该比对自有系统存储的姓名和本接口返回的姓名,作为最终结果。如果有必要的话,可以考虑比较自有系统和本接口返回的其他字段,进行更进一步的验证。

接口调用成功,不存在此考生时

SIGN验证成功时,返回 HTTP 200/OK,并输出 json 字符串,类似以下结果:

{"status":"40010","errmsg":"无此考生。","sign":"fa454fb784d1ca9d1fc938f052113936"}

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

  • status:接口内容状态。40010 代表根据输入的条件查询不到指定的考生。
  • errmsg:状态错误消息描述。
  • sign:将所有输出内容与 APPKEY 混合后生成的 MD5 摘要字符串。第三方应用应该使用同样的算法来验证输出是否可靠。

输入的参数不够时

SIGN验证成功时,返回 HTTP 200/OK,并输出 json 字符串,类似以下结果:

{"status":"40002","errmsg":"signup 操作的输入无效。","sign":"fa454fb784d1ca9d1fc938f052113936"}

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

第三方应用应该根据 status 判断接口内容是否得到了预期的结果,如果必要可将 errmsg 显示给用户。