完成了对CA系统的初步研究
这个提交包含在:
92
CA.yaml
普通文件
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
普通文件
7
readme.md
普通文件
@ -0,0 +1,7 @@
|
||||
# 网络API协议研究
|
||||
## 声明
|
||||
全部的API协议研究仅供学习用途,不对功能和可靠性作任何保证。
|
||||
|
||||
如果API协议有任何问题,不做任何担保。同时不对用户使用本API协议所实施的任何行为做任何担保。
|
||||
|
||||
全部API研究都是出于学习目的,如果学校或任何有关部门认为有必要,请立即联系作者**删除**这个API研究记录。
|
||||
61
信息门户.yaml
普通文件
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
|
||||
在新工单中引用
屏蔽一个用户