From cc1a8bfc79dd5f746791654937cb5c052e6da4e5 Mon Sep 17 00:00:00 2001
From: 10396 <1039655633@qq.com>
Date: Fri, 26 Sep 2025 10:18:43 +0800
Subject: [PATCH] =?UTF-8?q?```=20feat(api):=20=E6=B7=BB=E5=8A=A0=E8=AF=B7?=
=?UTF-8?q?=E6=B1=82=E5=8A=A0=E5=AF=86=E6=96=B9=E5=BC=8F=E8=AF=B4=E6=98=8E?=
=?UTF-8?q?=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
- 在 tabsList 中新增“请求加密方式”菜单项及其子项“POST请求加密方式”
- 调整后续 tab 项的 index，确保编号连续递增- 在 contentList 中添加详细的请求加密方式说明，包括： - 请求大小限制 - 请求头信息配置（X-app-Id、Content-Type） - 请求体 AES 加密与 Base64 编码方式 - 加密示例代码（Java）
- 更新所有 contentList项的 parentIndex，以匹配 tabsList 的新索引结构
```
---
src/views/api/index.vue | 264 ++++++++++++++++++++--------------------
1 file changed, 132 insertions(+), 132 deletions(-)
diff --git a/src/views/api/index.vue b/src/views/api/index.vue
index fc134c3..1f99035 100644
--- a/src/views/api/index.vue
+++ b/src/views/api/index.vue
@@ -168,6 +168,16 @@ const childrenIndex = ref(1);
const tabsList = ref([
{
index: 1,
+ name: "请求加密方式",
+ children: [
+ {
+ index: 1,
+ name: "POST请求加密方式",
+ },
+ ],
+ },
+ {
+ index: 2,
name: "双控信息数据",
children: [
{
@@ -231,7 +241,7 @@ const tabsList = ref([
],
},
{
- index: 2,
+ index: 3,
name: "道闸出入",
children: [
{
@@ -245,7 +255,7 @@ const tabsList = ref([
],
},
{
- index: 3,
+ index: 4,
name: "雷电预警",
children: [
{
@@ -263,7 +273,7 @@ const tabsList = ref([
],
},
{
- index: 4,
+ index: 5,
name: "人员信息",
children: [
{
@@ -297,7 +307,7 @@ const tabsList = ref([
],
},
{
- index: 5,
+ index: 6,
name: "特殊作业",
children: [
{
@@ -327,7 +337,7 @@ const tabsList = ref([
],
},
{
- index: 6,
+ index: 7,
name: "作业票",
children: [
{
@@ -389,7 +399,7 @@ const tabsList = ref([
],
},
{
- index: 7,
+ index: 8,
name: "综合管理",
children: [
{
@@ -410,21 +420,78 @@ const tabsList = ref([
},
],
},
- {
- index: 8,
- name: "请求加密方式",
- children: [
- {
- index: 1,
- name: "POST请求加密方式",
- },
- ],
- }
]);
const contentList = ref([
{
parentIndex: 1,
childrenIndex: 1,
+ title: "请求加密方式",
+ isHTML: true,
+ htmlStr: `
+
+
1.1、请求大小限制
+
+ 请求数据是list格式，但是为了请求效率，每次上报的请求数据在100条。
+ 对于特殊作业附件、视频智能分析附件上报接口，请求体大小要在 1M 内， 其他上报接口请求体的大小要在 15M 以内
+
+
+
1.2、请求头信息
+
+ 请求header中添加X-app-Id
+ 示例:X-app-Id : d2VpaHVhOjE1MzI0ODk3NTI0NTE5ODc0Ng==
+ 加密方式：将“服务平台编码:统一社会信用代码”字符串进行base64加密，服务平台编码和统一社会信用代码是在服务平台申请时填入
+ 请求头Content-Type : application/json
+
+
+
1.3、请求体加密
+
+ 请求体采用AES 加密方式，AES 加密需申请secretKey, 新申请接入的服务平台可申请。
+ 请求时，将请求信息转成json,先用AES 加密，再用Base64 对请求体的data 内容进行加密,最终效果为[{"data":"加密字符串"}]。
+
+
+
1.4、请求方式
+
+ 本文档中全部采用post请求方式
+
+
+
1.5、请求是否必填
+
+ 接口请求字段是否必填，依赖于推送的各个上游平台是否必填，在对接时可全部填写，可适配其他上游平台。
+ 每个上游平台字段是否必填,是通过平台配置，如果缺少必填字段项，在接口上报时会有异常返回提示。每个接口中的数据主键为必填项。
+
+
+
1.6、加密示例：
+
+
+ private static final String ALGORITHM = "AES";
+ private static final String TRANSFORMATION = "AES/ECB/PKCS5Padding";
+
+ public static String encrypt(String plainText, String base64Key) {
+ try {
+ byte[] decodedKey = Base64.getDecoder().decode(base64Key);
+ SecretKeySpec secretKey = new SecretKeySpec(decodedKey, ALGORITHM);
+
+ Cipher cipher = Cipher.getInstance(TRANSFORMATION);
+ cipher.init(Cipher.ENCRYPT_MODE, secretKey);
+
+ byte[] encryptedBytes = cipher.doFinal(plainText.getBytes(StandardCharsets.UTF_8));
+ return Base64.getEncoder().encodeToString(encryptedBytes);
+ } catch (Exception e) {
+ throw new RuntimeException("AES encryption failed", e);
+ }
+ }
+
+
-
1.1、请求大小限制
-
- 请求数据是list格式，但是为了请求效率，每次上报的请求数据在100条。
- 对于特殊作业附件、视频智能分析附件上报接口，请求体大小要在 1M 内， 其他上报接口请求体的大小要在 15M 以内
-
-
-
1.2、请求头信息
-
- 请求header中添加X-app-Id
- 示例:X-app-Id : d2VpaHVhOjE1MzI0ODk3NTI0NTE5ODc0Ng==
- 加密方式：将“服务平台编码:统一社会信用代码”字符串进行base64加密，服务平台编码和统一社会信用代码是在服务平台申请时填入
- 请求头Content-Type : application/json
-
-
-
1.3、请求体加密
-
- 请求体采用AES 加密方式，AES 加密需申请secretKey, 新申请接入的服务平台可申请。
- 请求时，将请求信息转成json,先用AES 加密，再用Base64 对请求体的data 内容进行加密,最终效果为[{"data":"加密字符串"}]。
-
-
-
1.4、请求方式
-
- 本文档中全部采用post请求方式
-
-
-
1.5、请求是否必填
-
- 接口请求字段是否必填，依赖于推送的各个上游平台是否必填，在对接时可全部填写，可适配其他上游平台。
- 每个上游平台字段是否必填,是通过平台配置，如果缺少必填字段项，在接口上报时会有异常返回提示。每个接口中的数据主键为必填项。
-
-
-
1.6、加密示例：
-
-
- private static final String ALGORITHM = "AES";
- private static final String TRANSFORMATION = "AES/ECB/PKCS5Padding";
-
- public static String encrypt(String plainText, String base64Key) {
- try {
- byte[] decodedKey = Base64.getDecoder().decode(base64Key);
- SecretKeySpec secretKey = new SecretKeySpec(decodedKey, ALGORITHM);
-
- Cipher cipher = Cipher.getInstance(TRANSFORMATION);
- cipher.init(Cipher.ENCRYPT_MODE, secretKey);
-
- byte[] encryptedBytes = cipher.doFinal(plainText.getBytes(StandardCharsets.UTF_8));
- return Base64.getEncoder().encodeToString(encryptedBytes);
- } catch (Exception e) {
- throw new RuntimeException("AES encryption failed", e);
- }
- }
-
-