完成了对CA系统的初步研究

这个提交包含在:
2025-12-20 02:07:25 +08:00
当前提交 2866ded95e
共有 3 个文件被更改,包括 160 次插入 和 0 次删除

92
CA.yaml 普通文件
查看文件

@ -0,0 +1,92 @@
openapi: 3.0.0
info :
title: "民大CA系统API文档"
version: "v1"
servers:
- url: "https://ca.muc.edu.cn"
paths:
/zfca/login:
description: 登录鉴权接口
get:
summary: 执行登录
parameters:
- name: service
in: query
description: 要访问的服务,需要在白名单之内
schema:
type: string
default: 'http://my.muc.edu.cn'
responses:
200:
description: 成功
post:
summary: 实际登录行为
parameters:
- name: service
in: query
description: 要访问的服务,需要在白名单之内
schema:
type: string
default: 'http://my.muc.edu.cn'
requestBody:
description: 登录所需要的用户数据
required: true
content:
application/x-www-form-urlencoded:
schema:
type: object
required:
- username
- password
- loginType
- flowId
properties:
username:
type: string
description: 用户名
example: "user123"
password:
type: string
description: SM2加密之后的密码(补充说明:某一次CA系统更新后要求的),同一个PublicKey编码的SM2密码可以使用多次
format: password
example: "your_password"
loginType:
type: string
description: 登录类型
enum: ["username_password"]
default: "username_password"
flowId:
type: string
description: FlowID,服务端用于验证,同时也是FlowID决定了登录后302的目标。只能使用一次,所以每次登录之前从ca请求flowid(在某次更新前,flowid是可使用多次的加密JWT字符串)
captcha:
type: string
description: 验证码(服务端决定是否需要)
example: ""
delegator:
type: string
description: 委托登录标识(未启用)
example: ""
tokenCode:
type: string
description: 令牌代码(未启用)
example: ""
continue:
type: string
description: 登录后继续的URL(未启用)
example: ""
asserts:
type: string
description: 断言信息(未启用)
example: ""
pageFrom:
type: string
description: 页面来源(未启用)
example: ""
submit:
type: string
description: 提交按钮值
example: "登录"
responses:
301:
description: 访问成功,发起重定向

7
readme.md 普通文件
查看文件

@ -0,0 +1,7 @@
# 网络API协议研究
## 声明
全部的API协议研究仅供学习用途,不对功能和可靠性作任何保证。
如果API协议有任何问题,不做任何担保。同时不对用户使用本API协议所实施的任何行为做任何担保。
全部API研究都是出于学习目的,如果学校或任何有关部门认为有必要,请立即联系作者**删除**这个API研究记录。

61
信息门户.yaml 普通文件
查看文件

@ -0,0 +1,61 @@
openapi: 3.0.0
info:
title: "MUC信息门户网站协议"
version: 'v1'
servers:
- url: 'https://my.muc.edu.cn'
paths:
/calendar/getCurrentWeek:
description: 获取当前周
post:
summary: 获取当前周
parameters:
- name: 'JSESSIONID'
in: cookie
description: 教务系统登录之后得到的标识符
schema:
type: string
responses:
200:
description: 当前周次信息
content:
application/json:
schema:
type: object
properties:
msg:
type: string
description: "请求状态"
default: "获取周次成功!"
state:
type: boolean
description: "请求状态"
default: true
data:
type: object
description: 实际返回内容
properties:
date:
type: string
description: "当前日期(UTC+8)"
example: "20251220"
hours:
type: string
description: "当前时(UTC+8),发送请求时的时间"
example: "01"
schoolYear:
type: string
description: "学年"
example: "2025-2026"
term:
type: string
description: "当前学期"
example: "秋季学期"
anyOf:
- example: "秋季学期"
- example: "夏季学期"
weekly:
type: integer
description: "当前教学周"
example: 16