更新接口约定

This commit is contained in:
谷成伟 2024-06-21 09:21:31 +08:00
parent 74912262cf
commit 989bfe8979

View File

@ -1,13 +1,23 @@
# 概述
## 接口约定
系统中的所有接口均遵循以下约定。
1. 除了与文件上传/下载相关的接口外,都是`POST`请求,请求报文使用`JSON`格式。
2. 文件下载使用GET请求(此种类型,加解密再讨论下)。
3. 文件上传使用POST请求请求报文使用`multipart/form-data`格式。
## 加密/解密
请求报文Header中需要添加参数
| 参数名称 | 说明 | |
| 参数名称 | 说明 | 备注 |
| -------- | -------- | --- |
| Token | 令牌 | |
| V | 加密向量 | |
| Token | 令牌 | 需要鉴权的API 才需要添加此参数 |
| V | 加密向量 | 必须添加 |
加密采用AES/CBC/ZeroPadding加密方式密钥长度为16位。IV长度为16位每次请求时随机生成
# 登录模块API接口