note/work/教育产业/比赛平台接口.md
2025-11-19 10:16:05 +08:00

3.7 KiB
Raw Permalink Blame History

比赛平台用户接口

修改需求

  • 删除学生接口当前接口直接从数据库内删除了学生而不是写删除标记位del_flag逻辑应该是先判断当前学生是否有报名记录如果有则不允许删除如果没有则可删除并将del_flag置为2。
  • /app/registration/userList 接口返回需增加比赛地点参赛人的报名的组别、学校名称、指导老师1、指导老师2.

大平台接口

提供根据手机号查询学生信息;但不提供学生照片。

密钥和接口文档

密码kBzrhWnEArk2AJskj8 账号Ekatong 接口文档:https://wlkj.suzhou.edu.cn/space/api/edu_sz/index.html 接口文档

获取系统token

https://wlkj.suzhou.edu.cn/v1/api/edu/suzhou/app-user/login POST application/json { "name": "Ekatong", "password": "kBzrhWnEArk2AJskj8" } 返回结果7200s有效期 HTTP/1.1 200 OK { "code": 1, "message": "SUCCESS", "result": "55494ffd78ef4eb5b3281dbfbab1f3b5" }

获取学生信息

  1. 根据学生身份证号获取学生信息 https://wlkj.suzhou.edu.cn/v1/api/edu/suzhou/student/find-by-nationalId POST application/json { "token": "55494ffd78ef4eb5b3281dbfbab1f3b5", "nationalId": "33010219900101001" } Response: { "code": 1, "message": "SUCCESS", "result": { "avatar": null, "className": null, "clazz": 70259, "enrollYear": 2022, "gender": 2, "grade": 12, "gradeName": "九年级", "name": "徐可馨", "nationalId": "Wqa75Z9mKyWxaiJTcFqFGyonmTLi/xvmX9GqavsVAt8=", "parents": null, "phone": null, "relation": null, "schoolId": 1731, "schoolName": "苏州市吴中区木渎实验中学", "status": 1 } }
  2. 根据家长身份证或手机获取

https://wlkj.suzhou.edu.cn/v1/api/edu/suzhou/student/find-by-parent POST application/json,nationalId和phone任选其一 { "token": "55494ffd78ef4eb5b3281dbfbab1f3b5", "nationalId": "320586198111298814", "phone": "17706212809" }

Response: { "code": 1, "message": "SUCCESS", "result": [ { "avatar": null, "className": "2210", "clazz": 70259, "enrollYear": 2022, "gender": 2, "grade": 12, "gradeName": "九年级", "name": "徐可馨", "nationalId": "Wqa75Z9mKyWxaiJTcFqFGyonmTLi/xvmX9GqavsVAt8=", "parents": null, "phone": null, "relation": "父子", "schoolId": 1731, "schoolName": "苏州市吴中区木渎实验中学", "status": 1 } ] } nationalId: AES解密ECB 模式key: "1c6e847bed8f49b5"

E卡通接口

提供根据学生身份证号,查询学生信息;提供学生照片。

根据学生身份证获取信息

https://ekt1.suzhou.edu.cn/szcarddev/szcard/cardEntrance POST application/json { "sign":"ek8Ta83lM0Ba", "method":"getStudentInfo", "type":"01",//04:市民卡号citizenCard "idCardNo":"320506201003100025", "appId":"Le6J0u14rVwOm8H4csT6pSi1c5dR7OOI" }

Response: { "birthday": "", "gradeName": "初中二年级", "gender": "1", "idCardNo": "320506201003100025", "regionName": "吴中区", "resultCode": "0", "className": "(10)班", "userName": "徐可馨", "imgUrl": "http://ekt.suzhou.edu.cn/group1/M00/08/15/rBIHN2AJL3aARW6RAA-mOHkosuE730.png", "returnCode": "0000", "returnMsg": "success", "phone": "", "gradeType": "0", "schoolName": "苏州市吴中区木渎实验中学", "ecardNumber": "0820189771" }

照片需要把imgUrl改为https://ekt1.suzhou.edu.cn/xxxx