贝壳小盒子V3
tjustb-edusys
tjustb-opacsys
Github
    • README
    • 前台接口
      • 微信小程序
        • 账户/登录
          • 获取登录凭证接口
      • 成绩
        • 获取成绩
        • 获取成绩查询选项
        • 学生获取培养方案
        • 获取成绩AI总结&建议
      • 校历
        • 校历查询筛选项
        • 校历查询
        • 当日校历周查询
        • 获取校历图
        • 获取所有校历图
      • 用户资料
        • 获取用户信息
        • 更新资料
      • 课表
        • 个人课表
          • 个人学期课表筛选项
          • 个人学期课表
          • 获取某日周课表
          • 获取某月课表
        • 班级课表
          • 班级课表筛选项
          • 班级课表专业选项
          • 获取班级课表
        • 教师课表
          • 教师课表筛选项
          • 获取教师课表
        • 课程课表
          • 课程课表筛选项
          • 获取课程课表
      • 教室
        • 教学地点列表
        • 教室借用情况筛选项
        • 教室借用状态查询
        • 教室借用详情
      • 首页组件
        • 今日电影推荐
        • 今日名人名言
        • 今日英文推荐
        • 今日诗词
        • 节假日列表
        • 批量获取组件数据
      • 教师
        • 教师查询授课列表
        • 教师查询课堂花名册
        • 获取培养方案选项列表
        • 教师查询专业培养方案
      • 校园生活
        • 音像放映
          • 获取某日放映安排
          • 获取某月放映日
        • 联系电话
        • 校园地图POI数据
        • 校园媒体列表
      • 学生评教
        • 获取需评教学期批次
        • 获取评教课程列表
        • 获取评教课程详情
      • webhook
        • 金价小程序Webhook
      • 登录接口
        POST
      • 获取手动登录参数
        GET
      • 手动登录
        POST
      • 登录页面背景图
        GET
      • 验证码识别接口
        POST
      • 图片/文件上传
        POST
      • 获取功能菜单树
        GET

    README

    贝壳小盒子用户端API接口#

    本接口文档面向 贝壳小盒子 用户端开发请求调用。
    用户端目前包含:H5端、微信小程序、QQ小程序.
    用户端使用uniapp开发打包其前端界面代码完全开源:shellbox-uniapp
    后端接口文档公开,项目代码仅开源教务系统部分composer依赖:tjustb-edusys

    登录鉴权#

    分为不鉴权、可鉴权、需鉴权三种类型:
    不鉴权接口直接发起请求即可;
    可鉴权接口推荐在请求Header部分有Auth参数,也可以不带Auth参数;
    需鉴权接口必须在请求Header部分有Auth参数,否则拒绝访问。

    Auth参数#

    Auth参数值需要先调用登录接口,登录成功后会返回得到。
    登录接口分为:手动登录和自动登录两种方式。
    1.
    自动登录
    请求调用登录接口 传入账号、密码即可,此接口会自动判断使用SSO登录还是教务登录,自动获取cookie、自动识别登录验证码尝试登录,由于高度自动化因此出错率也较高,如果多次调用无法成功登录建议尝试使用方法2手动登录。
    2.
    手动登录
    手动登录接口仅支持教务系统账号密码登录,暂不支持SSO账号密码登录。
    ①首先请求获取手动登录参数接口获取手动登录所需cookie值和验证码参数(验证码值是Base64图片);
    ②调用手动登录接口,传入账号、密码、cookie和验证码内容(验证码图片中的字符)。
    调用登录接口登录成功即可获得auth值,在后续请求调用接口时Header中携Auth字段值请求接口即可。
    修改于 2025-04-15 05:33:28
    下一页
    获取登录凭证接口
    Built with