From 2461efdde98a2509c7ac5a9fd56629aaecb8b281 Mon Sep 17 00:00:00 2001
From: tony.cheng <chengmingwei_1984122@126.com>
Date: Tue, 17 Mar 2026 12:05:37 +0800
Subject: [PATCH] enhance: 增强AI调解状态控制功能的健壮性和调试能力

---
 API文档.md |  140 ++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 140 insertions(+), 0 deletions(-)

diff --git "a/API\346\226\207\346\241\243.md" "b/API\346\226\207\346\241\243.md"
index bf8c52a..732f9d9 100644
--- "a/API\346\226\207\346\241\243.md"
+++ "b/API\346\226\207\346\241\243.md"
@@ -23,6 +23,8 @@
 
 Base URLs:
 
+* <a href="http://localhost:9015">开发环境: http://localhost:9015</a>
+
 # Authentication
 
 # AI云小调/典型案例查询
@@ -3077,6 +3079,26 @@
 
 ### 返回数据结构
 
+## GET 未命名接口
+
+GET /X
+
+> 返回示例
+
+> 200 Response
+
+```json
+{}
+```
+
+### 返回结果
+
+|状态码|状态码含义|说明|数据模型|
+|---|---|---|---|
+|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline|
+
+### 返回数据结构
+
 # AI云小调/AI调解实时看板
 
 ## GET 查询调解记录列表(实时看板专用)
@@ -3632,6 +3654,53 @@
 |» data|object|true|none||none|
 |»» startTime|string|true|none||none|
 |»» duration|string|true|none||none|
+
+## PUT 人工接管API
+
+PUT /api/v1/mediation-timeline/v2/case/202601301030001111/takeover
+
+> Body 请求参数
+
+```json
+{
+  "userName": "tony"
+}
+```
+
+### 请求参数
+
+|名称|位置|类型|必选|中文名|说明|
+|---|---|---|---|---|---|
+|body|body|object| 否 ||none|
+|» userName|body|string| 是 | 当前用户名|none|
+
+> 返回示例
+
+> 400 Response
+
+```json
+{
+  "code": 400,
+  "message": "案件已被接管,不允许重复接管",
+  "data": null
+}
+```
+
+### 返回结果
+
+|状态码|状态码含义|说明|数据模型|
+|---|---|---|---|
+|400|[Bad Request](https://tools.ietf.org/html/rfc7231#section-6.5.1)|none|Inline|
+
+### 返回数据结构
+
+状态码 **400**
+
+|名称|类型|必选|约束|中文名|说明|
+|---|---|---|---|---|---|
+|» code|integer|true|none||none|
+|» message|string|true|none||none|
+|» data|null|true|none||none|
 
 # AI云小调/调解协议
 
@@ -4247,5 +4316,76 @@
 |»» jobGroupId|string|true|none|工作组ID|none|
 |»» instanceId|string|true|none|场景ID|none|
 
+## POST 更新呼叫状态
+
+POST /api/v1/outbound-bot/update-status
+
+> Body 请求参数
+
+```json
+{
+  "jobId": "string",
+  "callStatus": "string"
+}
+```
+
+### 请求参数
+
+|名称|位置|类型|必选|中文名|说明|
+|---|---|---|---|---|---|
+|body|body|object| 否 ||none|
+|» jobId|body|string| 是 | 工作ID|none|
+|» callStatus|body|string| 是 | 外呼状态|none|
+
+> 返回示例
+
+> 200 Response
+
+```json
+{
+  "code": 200,
+  "message": "状态更新成功",
+  "data": null
+}
+```
+
+### 返回结果
+
+|状态码|状态码含义|说明|数据模型|
+|---|---|---|---|
+|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline|
+
+### 返回数据结构
+
+状态码 **200**
+
+|名称|类型|必选|约束|中文名|说明|
+|---|---|---|---|---|---|
+|» code|integer|true|none||none|
+|» message|string|true|none||none|
+|» data|null|true|none||none|
+
+# AI云小调/OCR识别AI总结
+
+## POST 自动获取文件ocr
+
+POST /api/v1/case-files-ocr/process
+
+> 返回示例
+
+> 200 Response
+
+```json
+{}
+```
+
+### 返回结果
+
+|状态码|状态码含义|说明|数据模型|
+|---|---|---|---|
+|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline|
+
+### 返回数据结构
+
 # 数据模型
 

--
Gitblit v1.8.0