完成了对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
|
||||||
在新工单中引用
屏蔽一个用户