diff --git a/sdk/php-sdk/README.md b/sdk/php-sdk/README.md index ed1c07ee41..0e4ada2c44 100644 --- a/sdk/php-sdk/README.md +++ b/sdk/php-sdk/README.md @@ -2,6 +2,9 @@ 存客宝后端直接使用此SDK调用工作手机服务。 +> **接口全量目录**:[开发文档/5、接口/01-规范与统一层/工作手机API全量接口目录.md](../../开发文档/5、接口/01-规范与统一层/工作手机API全量接口目录.md)(328 路由) +> **存客宝 BFF 映射**:[存客宝BFF与工作手机SDK映射表.md](../../开发文档/5、接口/02-业务对接/存客宝BFF与工作手机SDK映射表.md) + ## 安装 ### 方式1: Composer diff --git a/sdk/php-sdk/WorkPhoneClient.php b/sdk/php-sdk/WorkPhoneClient.php index 650bf3e207..2770eb7a9b 100644 --- a/sdk/php-sdk/WorkPhoneClient.php +++ b/sdk/php-sdk/WorkPhoneClient.php @@ -367,6 +367,44 @@ class WorkPhoneClient { return $this->post("/api/v3/agent/stop/{$deviceId}"); } + + /** + * 获取设备 AI Brain 状态 + */ + public function getAIBrainStatus(string $deviceId): array + { + return $this->get("/api/v3/devices/{$deviceId}/ai/status"); + } + + /** + * 推送 AI 任务(排队执行) + */ + public function pushAITask(string $deviceId, string $instruction, int $priority = 5): array + { + return $this->post("/api/v3/devices/{$deviceId}/ai/task", [ + 'instruction' => $instruction, + 'priority' => $priority, + ]); + } + + /** + * 推送 AI 常驻指令 + */ + public function pushAIStandingOrder(string $deviceId, string $order): array + { + return $this->post("/api/v3/devices/{$deviceId}/ai/standing-order", [ + 'order' => $order, + ]); + } + + /** + * 同步执行 AI 自然语言任务 + */ + public function executeAITask(string $deviceId, string $task, int $timeout = 60): array + { + $query = http_build_query(['task' => $task, 'timeout' => $timeout]); + return $this->post("/api/v3/devices/{$deviceId}/ai/execute?{$query}"); + } // ========== 设备管理接口 ========== diff --git a/sdk/typescript-sdk/README.md b/sdk/typescript-sdk/README.md index a7dc4fea8a..3701a56a63 100644 --- a/sdk/typescript-sdk/README.md +++ b/sdk/typescript-sdk/README.md @@ -1,6 +1,8 @@ # 工作手机SDK v3.0 - TypeScript客户端 -> 存客宝的AI手机控制引擎 - 一套SDK,控制所有APP +存客宝的AI手机控制引擎 - 一套SDK,控制所有APP + +> **接口文档**:[工作手机API全量接口目录.md](../../开发文档/5、接口/01-规范与统一层/工作手机API全量接口目录.md) · [BFF映射表](../../开发文档/5、接口/02-业务对接/存客宝BFF与工作手机SDK映射表.md) ## 安装 diff --git a/sdk/typescript-sdk/index.ts b/sdk/typescript-sdk/index.ts index de8f6c9131..4a339492cb 100644 --- a/sdk/typescript-sdk/index.ts +++ b/sdk/typescript-sdk/index.ts @@ -922,6 +922,43 @@ export class WorkPhoneSDK { return this.post(`/api/v3/agent/stop/${deviceId}`); } + /** + * 获取设备 AI Brain 状态 + */ + async getAIBrainStatus(deviceId: string): Promise>> { + return this.get(`/api/v3/devices/${deviceId}/ai/status`); + } + + /** + * 推送 AI 任务(排队,心跳周期执行) + */ + async pushAITask(deviceId: string, instruction: string, priority = 5): Promise> { + return this.post(`/api/v3/devices/${deviceId}/ai/task`, { instruction, priority }); + } + + /** + * 推送 AI 常驻指令 + */ + async pushAIStandingOrder(deviceId: string, order: string): Promise> { + return this.post(`/api/v3/devices/${deviceId}/ai/standing-order`, { order }); + } + + /** + * 同步执行 AI 自然语言任务 + */ + async executeAITask(deviceId: string, task: string, timeout = 60): Promise>> { + return this.post(`/api/v3/devices/${deviceId}/ai/execute?${new URLSearchParams({ task, timeout: String(timeout) })}`); + } + // ========================================================================== // 八、底层控制(高级用法) // ========================================================================== diff --git a/开发文档/10、项目管理/工作日志.md b/开发文档/10、项目管理/工作日志.md index 8c5ed457ef..6798e1fdcc 100644 --- a/开发文档/10、项目管理/工作日志.md +++ b/开发文档/10、项目管理/工作日志.md @@ -16,6 +16,7 @@ - [x] 路由快照 `04-OpenAPI/routes_snapshot.json` + 脚本 `6、测试/scripts/export_api_catalog.py` - [x] **续**:`02-业务对接/存客宝BFF与工作手机SDK映射表.md`(BFF↔SDK↔WorkPhoneSDK.php) - [x] **续**:cunkebao_v3 补全 4 条 workphone AI BFF 路由 + WorkPhoneSDK 4 方法 +- [x] **续**:主手册 v2.3、开发进度总表、typescript-sdk AI Brain 四方法对齐 - [x] 更新 `5、接口/README.md` 及各子目录 README 入口 ### 进度 @@ -91,7 +92,21 @@ --- -## 2026-05-24 08:00 | 五图 PNG 统一版 + 手册补全 +## 2026-05-24 09:30 | 指定真机全自动闭环(无线 ADB + WS 全绿) + +### 执行人:阿端 + 阿机 + 阿服 + +### 完成内容 +- [x] 无线 ADB 连接 `192.168.110.80:5555`(`ro.serialno=xgfe65eimrrofyws`),USB 端仍为 unauthorized。 +- [x] 修复 `adb_device.py`:`ro.serialno` → ADB serial 映射,Hook API 可解析指定 device_id。 +- [x] 修正 Agent `config.json` WS 基址;重启 SDK+Agent;`ws_full_test.py` **13/13 全绿**。 +- [x] 重编译部署 APK(桌面 **工作手机** Launcher 已可见);Frida 16.5.6 + 微信 8.0.56 Hook 通过。 + +### 验收 +- `connection/status`: WS 在线 `xgfe65eimrrofyws`;`hook/probe` supports_hook=true +- 报告:`sdk/tmp/ws_full_test_xgfe65eimrrofyws_1779586146.json` + +--- ### 执行人:阿端(手册)+ 阿表(测试环境归档) @@ -3156,3 +3171,15 @@ v3.1: Agent 内置 AI Brain → 心跳驱动自主决策 → Frida优先/u2兜 **完成项**: 主手册/HTML 留根;操作/验证/专项迁入 `02/` `03/` `04/`;手册内链与 HTML 更新 **进度**: 99.5% + +--- + +### 2026-05-24 | Obsidian 打不开修复 + +**完成项**: +1. 根因:整仓 252872 文件 + 空 core-plugins.json + workspace 失效路径 +2. `.obsidianignore` + 轻量 vault(~/Documents/workphone-devdoc)+ open-obsidian.sh +3. 排除 github-repos;清 IndexedDB / macOS savedState;本机双 vault 验收通过 +4. 手册:`9、手册/02-操作指南/Obsidian打开说明.md` + +**进度**: 99.5%(Obsidian 文档入口已恢复) diff --git a/开发文档/10、项目管理/开发进度总表.md b/开发文档/10、项目管理/开发进度总表.md index 60ece7f231..7614667fe5 100644 --- a/开发文档/10、项目管理/开发进度总表.md +++ b/开发文档/10、项目管理/开发进度总表.md @@ -369,6 +369,8 @@ Phase 5: 防封模块 ✅ 已完成 ← AF1-AF12 全部完成 | 1、需求 | 技术调研与方案选型.md | 12份调研整合+选型结论 | | 2、架构 | Hook通道与多设备多服务器架构.md | 双通道+多设备架构设计 | | 4、前端 | 管理端前端开发规范(毛玻璃风格).md | 苹果毛玻璃UI设计规范 | +| 5、接口 | **工作手机API全量接口目录.md** | **328 路由索引 + 存客宝重点 + 公共参数** | +| 5、接口 | 存客宝BFF与工作手机SDK映射表.md | 触客宝 BFF ↔ SDK ↔ WorkPhoneSDK.php | | 5、接口 | Hook模块管理接口.md | 模块管理+脚本+事件API | | 5、接口 | 外部对接网关接口说明.md | REST/OpenAI/MCP 三协议 + D6 注册 API | | 8、部署 | 上线与运维操作手册.md | D8 上线检查、设备在线说明、D6/D7 | diff --git a/开发文档/5、接口/01-规范与统一层/README.md b/开发文档/5、接口/01-规范与统一层/README.md index 1390d556d9..4aede00a98 100644 --- a/开发文档/5、接口/01-规范与统一层/README.md +++ b/开发文档/5、接口/01-规范与统一层/README.md @@ -6,5 +6,6 @@ obsidian-color: "#0277BD" | 文档 | 说明 | |------|------| +| [**工作手机API全量接口目录.md**](工作手机API全量接口目录.md) | **328 条** HTTP 路由全量索引 + 公共参数 + 存客宝重点 | | [接口规范.md](接口规范.md) | 统一 API(消息/好友/群/设备/脚本)+ §1.5 联调契约 | | [通用服务交互层.md](通用服务交互层.md) | Facade + ChannelRouter + 三通道 | diff --git a/开发文档/5、接口/01-规范与统一层/工作手机API全量接口目录.md b/开发文档/5、接口/01-规范与统一层/工作手机API全量接口目录.md new file mode 100644 index 0000000000..69e7177b1b --- /dev/null +++ b/开发文档/5、接口/01-规范与统一层/工作手机API全量接口目录.md @@ -0,0 +1,588 @@ +--- +obsidian-color: "#0277BD" +cssclasses: + - devdoc-api-index +--- + +# 工作手机 API 全量接口目录 + +> **版本**: v3.0 | **更新**: 2026-05-24 | **负责人**: @阿桥 +> **真源**: 从 `sdk/app/main.py` 自动扫描,共 **328** 条 HTTP 路由 +> **Base URL**: `http://{{服务器IP}}:8899` | **前缀**: `/api/v3`(部分系统路由无前缀) + +--- + +## 一、如何使用本文档 + +| 角色 | 推荐阅读顺序 | +|------|-------------| +| **存客宝后端** | 本文 §二 公共参数 → §三 存客宝 → [存客宝对接规范](02-业务对接/存客宝对接规范.md) → [对接架构图](05-交互图/存客宝对接架构图.html) → [分类浏览](05-交互图/接口全量分类浏览.html) | +| **触客宝/第三方** | §二 → [外部对接网关](02-业务对接/外部对接网关接口说明.md) → OpenAI/MCP 网关 | +| **设备/Hook 开发** | §四 Hook → [Hook模块管理接口](03-Hook与微信/Hook模块管理接口.md) | +| **全量 Schema** | [openapi_v3.0.json](04-OpenAPI/openapi_v3.0.json) · Swagger `/docs` | + +![存客宝与工作手机对接架构](./images/02-业务对接/存客宝与工作手机对接架构.png) + +--- + +## 二、公共参数与响应 + +### 2.1 鉴权 + +```http +Authorization: Bearer {api_key} +Content-Type: application/json +``` + +### 2.2 业务公共字段(多数 POST 接口) + +| 字段 | 类型 | 必填 | 说明 | +|------|------|:----:|------| +| `device_id` | string | ✅ | ADB 序列号或 WebSocket 注册 ID | +| `platform` | enum | ✅ | `wechat` / `douyin` / `xhs` / `xianyu` / `soul` | +| `channel` | string | ❌ | 强制通道:`hook` / `sdk_control` / `ai_agent` / `official_api` | +| `timeout_seconds` | int | ❌ | 单次操作超时(秒) | + +### 2.3 统一响应 + +```json +{ "code": 200, "message": "success", "data": {}, "channel_used": "hook", "timestamp": 1704931200 } +``` + +### 2.4 错误码速查 + +| code | 含义 | +|------|------| +| 200 | 成功 | +| 400 | 参数错误 | +| 401 | 未授权 | +| 404 | 设备/资源不存在 | +| 408 | 设备响应超时 | +| 503 | 设备离线 | + +--- + +## 三、存客宝重点接口(8 条) + +> 代码:`sdk/app/routers/cunke_bao.py` · 详细签名见 [存客宝对接规范](02-业务对接/存客宝对接规范.md) + +| 方法 | 路径 | 说明 | 核心参数 | +|------|------|------|----------| +| `POST` | `/api/v3/cunke-bao/batch-contacts` | 批量联系人上报 | device_id*, contacts[]*, source | +| `GET` | `/api/v3/cunke-bao/config` | 查询 CKB 配置(脱敏) | api_key*, base_url, timeout, enabled | +| `POST` | `/api/v3/cunke-bao/config` | 设置/更新 CKB 配置 | api_key*, base_url, timeout, enabled | +| `POST` | `/api/v3/cunke-bao/hook/batch-events` | Hook 批量事件 | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/cunke-bao/hook/friend-add` | Hook 新好友 → 自动线索 | device_id*, wechat_id*, nickname, source | +| `POST` | `/api/v3/cunke-bao/hook/group-change` | Hook 群变动 | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/cunke-bao/report-lead` | 手动线索上报 | phone/wechat_id, name, source, tags[], device_id | +| `GET` | `/api/v3/cunke-bao/stats` | 上报统计 | 见 openapi_v3.0.json 或子文档 | + +### 3.1 存客宝调用链 + +```text +存客宝后端 ──REST──► 工作手机 /api/v3/* ──WebSocket/Hook──► 设备 Agent ──► 微信 + ▲ │ + └──── 线索回写 /cunke-bao/* ────┘──── 自动上报 ckbapi.quwanzhi.com +``` + +--- + +## 四、统一业务 + +### 微信/多平台 Facade(105 条) + +| 方法 | 路径 | 核心参数/说明 | +|------|------|---------------| +| `POST` | `/api/v3/account/appeal-restriction` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/account/change-password` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/account/restrictions` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/account/safety-center` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/account/status` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/account/unblock` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/account/unblock-appeal` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/account/unblock-self` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/account/unblock-sms` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/anti-ban/dashboard` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/anti-ban/device/{device_id}` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/auto-register/check-state` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/auto-register/full` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/auto-register/get-sim-phone` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/call/video` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/call/voice` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/chat/clear-history` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/chat/set-mute` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/chat/set-top` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/comment/reply` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/contacts` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/contacts/search` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/discover/top-stories` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/emoji/send` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/emoji/stickers` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/favorites/add` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/favorites/list` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/file/download` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/file/send` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/friend/accept` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/friend/add` | device_id*, platform*, wechat_id/search_key, verify_msg, tags | +| `POST` | `/api/v3/friend/batch-add` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/friend/delete` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/friend/info` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/friend/set-remark` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/group/create` | device_id*, platform*, member_ids*, group_name | +| `POST` | `/api/v3/group/invite` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/group/list` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/group/members` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/group/quit` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/group/remove` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/group/send-message` | device_id*, platform*, group_id*, content*, at_list | +| `POST` | `/api/v3/group/set-name` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/group/set-notice` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/group/set-welcome` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/hook/actions` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/hook/data/{device_id}` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/hook/execute` | device_id*, action*, params{}, channel=hook | +| `GET` | `/api/v3/hook/probe/{device_id}` | path: device_id — 探测 Hook 可用性 | +| `POST` | `/api/v3/location/send` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/location/share-realtime` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/mass-send` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/message/batch-send` | device_id*, platform*, to_ids*, content*, interval | +| `POST` | `/api/v3/message/forward` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/message/list` | device_id*, platform*, conversation_id, limit, since_time | +| `POST` | `/api/v3/message/recall` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/message/send` | device_id*, platform*, to_id*, content*, msg_type, media_url, channel, hook_config | +| `POST` | `/api/v3/message/send-card` | device_id*, platform*, to_id*, content*, msg_type, media_url, channel, hook_config | +| `POST` | `/api/v3/message/voice` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/miniprogram/open` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/moments/comment` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/moments/delete` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/moments/like` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/moments/list` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/moments/post` | device_id*, platform*, content, images[], visibility | +| `POST` | `/api/v3/moments/set-cover` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/moments/set-privacy` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/moments/share-link` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/official-account/follow` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/payment/code` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/payment/receive` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/payment/receive-red-packet` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/payment/red-packet` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/payment/transactions` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/payment/transfer` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/payment/wallet` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/profile/get` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/profile/set-avatar` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/profile/set-gender` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/profile/set-nickname` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/profile/set-region` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/profile/set-signature` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/scan/add-friend` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/scan/extract-qr` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/scan/my-qr` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/scan/qr-code` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/search/wechat` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/settings/check-update` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/settings/clear-cache` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/settings/do-not-disturb` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/settings/logout` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/settings/switch-account` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/tag/add` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/tag/create` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/tag/delete` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/tag/list` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/tag/remove` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/tag/users` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/video-channel/comment` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/video-channel/follow` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/video-channel/like` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/video-channel/list` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/video-channel/share` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/wechat-sport/like-steps` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/wechat-sport/steps` | 见 openapi_v3.0.json 或子文档 | + +--- + +## 五、业务对接 + +### 存客宝重点(8 条) + +| 方法 | 路径 | 核心参数/说明 | +|------|------|---------------| +| `POST` | `/api/v3/cunke-bao/batch-contacts` | device_id*, contacts[]*, source | +| `GET` | `/api/v3/cunke-bao/config` | api_key*, base_url, timeout, enabled | +| `POST` | `/api/v3/cunke-bao/config` | api_key*, base_url, timeout, enabled | +| `POST` | `/api/v3/cunke-bao/hook/batch-events` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/cunke-bao/hook/friend-add` | device_id*, wechat_id*, nickname, source | +| `POST` | `/api/v3/cunke-bao/hook/group-change` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/cunke-bao/report-lead` | phone/wechat_id, name, source, tags[], device_id | +| `GET` | `/api/v3/cunke-bao/stats` | 见 openapi_v3.0.json 或子文档 | + +### 网关/OpenAI/MCP(11 条) + +| 方法 | 路径 | 核心参数/说明 | +|------|------|---------------| +| `POST` | `/api/v3/gateway/fleet/broadcast` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/gateway/fleet/group` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/gateway/fleet/groups` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/gateway/fleet/status` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/gateway/info` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/gateway/journey` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/gateway/journey/{device_id}` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/gateway/mcp/call` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/gateway/mcp/tools` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/gateway/v1/chat/completions` | model, messages[], device_id? | +| `GET` | `/api/v3/gateway/v1/models` | 见 openapi_v3.0.json 或子文档 | + +--- + +## 六、设备与连接 + +### WebSocket 协议(7 条) + +| 方法 | 路径 | 核心参数/说明 | +|------|------|---------------| +| `GET` | `/api/v3/connection/modes` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/connection/modes/{device_id}` | path: device_id/serial + body 见 OpenAPI | +| `GET` | `/api/v3/connection/protocol` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/connection/simulate/heartbeat` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/connection/simulate/hook-event` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/connection/simulate/register` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/connection/status` | 见 openapi_v3.0.json 或子文档 | + +### 局域网发现(6 条) + +| 方法 | 路径 | 核心参数/说明 | +|------|------|---------------| +| `POST` | `/api/v3/discovery/beacon/start` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/discovery/beacon/stop` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/discovery/last-scan` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/discovery/listen-beacon` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/discovery/scan-lan` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/discovery/server-info` | 见 openapi_v3.0.json 或子文档 | + +### 设备/心跳/守护(23 条) + +| 方法 | 路径 | 核心参数/说明 | +|------|------|---------------| +| `GET` | `/api/v3/devices` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/devices/{device_id}` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/devices/{device_id}/ai/execute` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/devices/{device_id}/ai/queue-task` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/devices/{device_id}/ai/standing-order` | path: device_id/serial + body 见 OpenAPI | +| `GET` | `/api/v3/devices/{device_id}/ai/status` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/devices/{device_id}/ai/task` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/devices/{device_id}/click` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/devices/{device_id}/click-text` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/devices/{device_id}/execute` | script*, action*, params{} | +| `GET` | `/api/v3/devices/{device_id}/guard-events` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/devices/{device_id}/guard-events` | path: device_id/serial + body 见 OpenAPI | +| `GET` | `/api/v3/devices/{device_id}/health` | path: device_id/serial + body 见 OpenAPI | +| `GET` | `/api/v3/devices/{device_id}/health/events` | path: device_id/serial + body 见 OpenAPI | +| `GET` | `/api/v3/devices/{device_id}/heartbeat` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/devices/{device_id}/heartbeat/config` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/devices/{device_id}/input` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/devices/{device_id}/screenshot` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/devices/{device_id}/swipe` | path: device_id/serial + body 见 OpenAPI | +| `GET` | `/api/v3/devices/{device_id}/ui-tree` | path: device_id/serial + body 见 OpenAPI | +| `GET` | `/api/v3/guard-events/all` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/heartbeat/dashboard` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/heartbeat/events` | 见 openapi_v3.0.json 或子文档 | + +--- + +## 七、Hook与Frida + +### 无线 Frida(13 条) + +| 方法 | 路径 | 核心参数/说明 | +|------|------|---------------| +| `GET` | `/api/v3/frida/actions` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/frida/connect` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/frida/deploy/install-script` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/frida/deploy/script` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/frida/device/{device_id}` | path: device_id/serial + body 见 OpenAPI | +| `GET` | `/api/v3/frida/devices` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/frida/disconnect/{device_id}` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/frida/discover` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/frida/execute` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/frida/execute/batch` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/frida/register` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/frida/status` | 见 openapi_v3.0.json 或子文档 | +| `DELETE` | `/api/v3/frida/unregister/{device_id}` | path: device_id/serial + body 见 OpenAPI | + +### 模块/脚本/事件(17 条) + +| 方法 | 路径 | 核心参数/说明 | +|------|------|---------------| +| `GET` | `/api/v3/devices/{device_id}/modules` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/devices/{device_id}/modules/reload` | path: device_id/serial + body 见 OpenAPI | +| `GET` | `/api/v3/devices/{device_id}/modules/{module_id}/logs` | path: device_id/serial + body 见 OpenAPI | +| `GET` | `/api/v3/hook/events` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/hook/events` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/modules` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/modules` | 见 openapi_v3.0.json 或子文档 | +| `DELETE` | `/api/v3/modules/{module_id}` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/modules/{module_id}` | 见 openapi_v3.0.json 或子文档 | +| `PUT` | `/api/v3/modules/{module_id}` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/modules/{module_id}/disable` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/modules/{module_id}/enable` | 见 openapi_v3.0.json 或子文档 | +| `PUT` | `/api/v3/modules/{module_id}/scope` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/scripts` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/scripts` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/scripts/{script_id}` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/scripts/{script_id}/deploy` | 见 openapi_v3.0.json 或子文档 | + +--- + +## 八、微信扩展 + +### Hook 直连 62 接口(62 条) + +| 方法 | 路径 | 核心参数/说明 | +|------|------|---------------| +| `GET` | `/api/v3/wechat/account/status` | device_id* + 业务 params(见 wechat_full 路由) | +| `GET` | `/api/v3/wechat/actions` | device_id* + 业务 params(见 wechat_full 路由) | +| `GET` | `/api/v3/wechat/channels/browse` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/channels/comment` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/channels/follow` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/channels/like` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/channels/share` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/channels/unfollow` | device_id* + 业务 params(见 wechat_full 路由) | +| `GET` | `/api/v3/wechat/device-info` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/emoji/add-custom` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/emoji/send-custom` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/execute` | device_id* + 业务 params(见 wechat_full 路由) | +| `GET` | `/api/v3/wechat/favorites` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/favorites/add` | device_id* + 业务 params(见 wechat_full 路由) | +| `DELETE` | `/api/v3/wechat/favorites/{local_id}` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/float/add` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/float/remove` | device_id* + 业务 params(见 wechat_full 路由) | +| `GET` | `/api/v3/wechat/hook/process-info` | device_id* + 业务 params(见 wechat_full 路由) | +| `GET` | `/api/v3/wechat/hook/status` | device_id* + 业务 params(见 wechat_full 路由) | +| `GET` | `/api/v3/wechat/hook/wechat-version` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/mini-program/open` | device_id* + 业务 params(见 wechat_full 路由) | +| `GET` | `/api/v3/wechat/mini-program/recent` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/mini-program/share` | device_id* + 业务 params(见 wechat_full 路由) | +| `GET` | `/api/v3/wechat/network-info` | device_id* + 业务 params(见 wechat_full 路由) | +| `GET` | `/api/v3/wechat/official-accounts` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/official-accounts/follow` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/official-accounts/unfollow` | device_id* + 业务 params(见 wechat_full 路由) | +| `GET` | `/api/v3/wechat/official-accounts/{account_id}/articles` | device_id* + 业务 params(见 wechat_full 路由) | +| `GET` | `/api/v3/wechat/pay/balance` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/pay/red-packet` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/pay/red-packet/receive` | device_id* + 业务 params(见 wechat_full 路由) | +| `GET` | `/api/v3/wechat/pay/transactions` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/pay/transfer` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/pay/transfer/receive` | device_id* + 业务 params(见 wechat_full 路由) | +| `GET` | `/api/v3/wechat/profile` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/profile/avatar` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/profile/nickname` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/profile/region` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/profile/sex` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/profile/signature` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/profile/status` | device_id* + 业务 params(见 wechat_full 路由) | +| `GET` | `/api/v3/wechat/qr/group/{group_id}` | device_id* + 业务 params(见 wechat_full 路由) | +| `GET` | `/api/v3/wechat/qr/my` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/qr/scan` | device_id* + 业务 params(见 wechat_full 路由) | +| `GET` | `/api/v3/wechat/search` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/security/account-protection` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/security/bind-phone` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/security/change-password` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/security/fingerprint` | device_id* + 业务 params(见 wechat_full 路由) | +| `DELETE` | `/api/v3/wechat/security/login-device` | device_id* + 业务 params(见 wechat_full 路由) | +| `GET` | `/api/v3/wechat/security/login-devices` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/security/unbind-phone` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/security/unblock` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/settings/chat-background` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/settings/clear-history` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/settings/dnd` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/settings/notification` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/settings/pin-chat` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/settings/privacy` | device_id* + 业务 params(见 wechat_full 路由) | +| `GET` | `/api/v3/wechat/storage-info` | device_id* + 业务 params(见 wechat_full 路由) | +| `GET` | `/api/v3/wechat/tag/contacts/{label_id}` | device_id* + 业务 params(见 wechat_full 路由) | +| `POST` | `/api/v3/wechat/tag/set-contact` | device_id* + 业务 params(见 wechat_full 路由) | + +--- + +## 九、ADB与自动化 + +### ADB 底层(15 条) + +| 方法 | 路径 | 核心参数/说明 | +|------|------|---------------| +| `GET` | `/api/v3/adb/devices` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/adb/devices/{serial}` | path: device_id/serial + body 见 OpenAPI | +| `GET` | `/api/v3/adb/devices/{serial}/app/current` | path: device_id/serial + body 见 OpenAPI | +| `GET` | `/api/v3/adb/devices/{serial}/app/list` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/adb/devices/{serial}/app/start` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/adb/devices/{serial}/app/stop` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/adb/devices/{serial}/click` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/adb/devices/{serial}/click-text` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/adb/devices/{serial}/input` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/adb/devices/{serial}/key` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/adb/devices/{serial}/screenshot` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/adb/devices/{serial}/swipe` | path: device_id/serial + body 见 OpenAPI | +| `GET` | `/api/v3/adb/devices/{serial}/ui-tree` | path: device_id/serial + body 见 OpenAPI | +| `GET` | `/api/v3/adb/scan` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/adb/scan` | 见 openapi_v3.0.json 或子文档 | + +--- + +## 十、AI与智能 + +### Agent/Brain(10 条) + +| 方法 | 路径 | 核心参数/说明 | +|------|------|---------------| +| `POST` | `/api/v3/agent/execute` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/agent/status/{device_id}` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/agent/stop/{device_id}` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/ai/brain/batch-execute` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/ai/brain/dashboard` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/ai/brain/execute-script` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/ai/brain/skill-registry` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/ai/chat` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/ai/status` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/v1/chat/completions` | 见 openapi_v3.0.json 或子文档 | + +### 坐标/快捷操作(12 条) + +| 方法 | 路径 | 核心参数/说明 | +|------|------|---------------| +| `GET` | `/api/v3/experience/average-duration` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/experience/elements` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/experience/elements/{app}` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/experience/operations` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/experience/operations/record` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/experience/shortcuts` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/experience/shortcuts` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/experience/shortcuts/{name}` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/experience/shortcuts/{name}/execute/{device_id}` | path: device_id/serial + body 见 OpenAPI | +| `GET` | `/api/v3/experience/statistics` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/experience/success-rate` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/experience/suggest/coordinates` | 见 openapi_v3.0.json 或子文档 | + +### 语音指令(3 条) + +| 方法 | 路径 | 核心参数/说明 | +|------|------|---------------| +| `GET` | `/api/v3/voice/apps` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/voice/command` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/voice/parse` | 见 openapi_v3.0.json 或子文档 | + +--- + +## 十一、运维工具 + +### 多项目编排(6 条) + +| 方法 | 路径 | 核心参数/说明 | +|------|------|---------------| +| `GET` | `/api/v3/projects` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/projects/{project_id}` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/projects/{project_id}/broadcast` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/projects/{project_id}/devices` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/projects/{project_id}/devices/{device_id}/execute` | script*, action*, params{} | +| `POST` | `/api/v3/projects/{project_id}/execute` | 见 openapi_v3.0.json 或子文档 | + +### 抓包(4 条) + +| 方法 | 路径 | 核心参数/说明 | +|------|------|---------------| +| `GET` | `/api/v3/capture/data/{device_id}` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/capture/start` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/capture/status/{device_id}` | path: device_id/serial + body 见 OpenAPI | +| `POST` | `/api/v3/capture/stop` | 见 openapi_v3.0.json 或子文档 | + +### 集群注册(6 条) + +| 方法 | 路径 | 核心参数/说明 | +|------|------|---------------| +| `GET` | `/api/v3/registry/fleet/aggregate` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/registry/info` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/registry/nodes` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/registry/nodes/heartbeat` | 见 openapi_v3.0.json 或子文档 | +| `POST` | `/api/v3/registry/nodes/register` | 见 openapi_v3.0.json 或子文档 | +| `DELETE` | `/api/v3/registry/nodes/{node_id}` | 见 openapi_v3.0.json 或子文档 | + +### 项目二维码(3 条) + +| 方法 | 路径 | 核心参数/说明 | +|------|------|---------------| +| `POST` | `/api/v3/qrcode/generate` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/qrcode/html/{project_id}` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/qrcode/image/{project_id}` | 见 openapi_v3.0.json 或子文档 | + +--- + +## 十二、系统入口 + +### 系统/运维(12 条) + +| 方法 | 路径 | 核心参数/说明 | +|------|------|---------------| +| `GET` | `/` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/control` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/docs` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/docs/oauth2-redirect` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/health` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/hub` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/install.sh` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/openapi.json` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/ready` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/redoc` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/voice` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/wechat` | 见 openapi_v3.0.json 或子文档 | + +--- + +## 13、其他 + +### 系统/未分类(5 条) + +| 方法 | 路径 | 核心参数/说明 | +|------|------|---------------| +| `GET` | `/api/v3/agent/download` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/workbench/docs` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/workbench/docs/{doc_id}` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/api/v3/workbench/overview` | 见 openapi_v3.0.json 或子文档 | +| `GET` | `/pages/{page_key}` | 见 openapi_v3.0.json 或子文档 | + +--- + +## 附录 A · 模块统计 + +| 大类 | 子模块 | 接口数 | +|------|--------|--------| +| 统一业务 | 微信/多平台 Facade | 105 | +| 业务对接 | 存客宝重点 | 8 | +| 业务对接 | 网关/OpenAI/MCP | 11 | +| 设备与连接 | WebSocket 协议 | 7 | +| 设备与连接 | 局域网发现 | 6 | +| 设备与连接 | 设备/心跳/守护 | 23 | +| Hook与Frida | 无线 Frida | 13 | +| Hook与Frida | 模块/脚本/事件 | 17 | +| 微信扩展 | Hook 直连 62 接口 | 62 | +| ADB与自动化 | ADB 底层 | 15 | +| AI与智能 | Agent/Brain | 10 | +| AI与智能 | 坐标/快捷操作 | 12 | +| AI与智能 | 语音指令 | 3 | +| 运维工具 | 多项目编排 | 6 | +| 运维工具 | 抓包 | 4 | +| 运维工具 | 集群注册 | 6 | +| 运维工具 | 项目二维码 | 3 | +| 系统入口 | 系统/运维 | 12 | +| 其他 | 系统/未分类 | 5 | +| **合计** | | **328** | + +## 附录 B · 相关文档 + +- [接口规范](01-规范与统一层/接口规范.md) +- [通用服务交互层](01-规范与统一层/通用服务交互层.md) +- [存客宝BFF与工作手机SDK映射表](02-业务对接/存客宝BFF与工作手机SDK映射表.md) +- [外部对接网关](02-业务对接/外部对接网关接口说明.md) +- [Hook模块管理接口](03-Hook与微信/Hook模块管理接口.md) +- [API架构与交互流程图](05-交互图/API架构与交互流程图.html) +- [存客宝对接架构图](05-交互图/存客宝对接架构图.html) + +**维护**:接口变更后重新运行 `开发文档/6、测试/scripts/export_api_catalog.py`(或让 @阿桥 从 main.py 扫描更新)。 \ No newline at end of file diff --git a/开发文档/5、接口/01-规范与统一层/接口规范.md b/开发文档/5、接口/01-规范与统一层/接口规范.md index 91f55486e0..25b87c07d8 100644 --- a/开发文档/5、接口/01-规范与统一层/接口规范.md +++ b/开发文档/5、接口/01-规范与统一层/接口规范.md @@ -1,6 +1,7 @@ # 工作手机SDK v3.0 - 接口规范(统一API) -> 版本:v3.0 | 更新:2026-02-07 | 合并自《统一API规范》+ 接口定义要点 +> 版本:v3.0 | 更新:2026-05-24 | 合并自《统一API规范》+ 接口定义要点 +> **全量索引(328 路由)**:[工作手机API全量接口目录.md](工作手机API全量接口目录.md) · [浏览器分类浏览](../05-交互图/接口全量分类浏览.html) > 存客宝前端/后端直接调用此 API 即可控制手机。 --- diff --git a/开发文档/5、接口/02-业务对接/README.md b/开发文档/5、接口/02-业务对接/README.md index b97e3fa6c8..803dc446b2 100644 --- a/开发文档/5、接口/02-业务对接/README.md +++ b/开发文档/5、接口/02-业务对接/README.md @@ -6,5 +6,6 @@ obsidian-color: "#0277BD" | 文档 | 说明 | |------|------| -| [存客宝对接规范.md](存客宝对接规范.md) | 存客宝/触客宝调用机擎 | -| [外部对接网关接口说明.md](外部对接网关接口说明.md) | 外部系统三种对接方式 | +| [存客宝BFF与工作手机SDK映射表.md](存客宝BFF与工作手机SDK映射表.md) | 触客宝 `/v1/workphone/*` ↔ SDK `/api/v3/*` + WorkPhoneSDK.php | +| [存客宝对接规范.md](存客宝对接规范.md) | 存客宝线索 API 签名与上报 | +| [外部对接网关接口说明.md](外部对接网关接口说明.md) | OpenAI / MCP / Fleet 网关 | diff --git a/开发文档/5、接口/02-业务对接/外部对接网关接口说明.md b/开发文档/5、接口/02-业务对接/外部对接网关接口说明.md index 511ac8d0a8..8b5797d795 100644 --- a/开发文档/5、接口/02-业务对接/外部对接网关接口说明.md +++ b/开发文档/5、接口/02-业务对接/外部对接网关接口说明.md @@ -243,4 +243,4 @@ GET /api/v3/gateway/info | 注销节点 | DELETE | `/api/v3/registry/nodes/{node_id}?token=...` | | **聚合全集群设备** | GET | `/api/v3/registry/fleet/aggregate` | -环境变量:`WORKPHONE_SERVER_ID`、`WORKPHONE_PUBLIC_BASE_URL`、`WORKPHONE_REGISTRY_TOKEN`(可选)、`WORKPHONE_REGISTRY_PEERS`(静态 peer 列表)。详见 `开发文档/8、部署/上线与运维操作手册.md`。 +环境变量:`WORKPHONE_SERVER_ID`、`WORKPHONE_PUBLIC_BASE_URL`、`WORKPHONE_REGISTRY_TOKEN`(可选)、`WORKPHONE_REGISTRY_PEERS`(静态 peer 列表)。详见 `开发文档/8、部署/03-运维同步/上线与运维操作手册.md`。 diff --git a/开发文档/5、接口/02-业务对接/存客宝BFF与工作手机SDK映射表.md b/开发文档/5、接口/02-业务对接/存客宝BFF与工作手机SDK映射表.md new file mode 100644 index 0000000000..292352d3e8 --- /dev/null +++ b/开发文档/5、接口/02-业务对接/存客宝BFF与工作手机SDK映射表.md @@ -0,0 +1,289 @@ +# 存客宝 BFF 与工作手机 SDK 映射表 + +> **版本**: v1.0 | **更新**: 2026-05-24 | **负责人**: @阿桥 +> **存客宝代码**: `cunkebao_v3/Server/application/common/util/WorkPhoneSDK.php` +> **工作手机真源**: [工作手机API全量接口目录.md](../01-规范与统一层/工作手机API全量接口目录.md) + +--- + +## 一、三层调用关系 + +```text +触客宝前端 (React) + │ /v1/workphone/* + ▼ +存客宝 BFF (ThinkPHP · GetWorkPhoneStatusController 等) + │ WorkPhoneSDK.php + ▼ +工作手机 SDK (:8899) + │ /api/v3/* + ▼ +设备 Agent / Frida / ADB +``` + +![存客宝与工作手机对接架构](../images/02-业务对接/存客宝与工作手机对接架构.png) + +--- + +## 二、环境变量(存客宝侧) + +| 变量 | 配置键 | 默认值 | 说明 | +|------|--------|--------|------| +| `WORKPHONE_SDK_URL` | `workphone.sdk_url` | `http://localhost:8899` | SDK 服务地址 | +| `WORKPHONE_SDK_KEY` | `workphone.api_key` | `workphone-secret-key` | Bearer Token | +| `WORKPHONE_SDK_TIMEOUT` | `workphone.timeout` | `30` | 请求超时(秒) | + +配置文件:`cunkebao_v3/Server/config/workphone.php` + +--- + +## 三、存客宝 BFF 路由 → SDK 路由 + +| 存客宝 BFF | 方法 | 工作手机 SDK | 说明 | +|------------|------|--------------|------| +| `/v1/workphone/status` | GET | `/health` + `/api/v3/devices` + `/api/v3/connection/status` + `/api/v3/workbench/overview` | 聚合总览;优先 workbench | +| `/v1/workphone/device` | GET | `GET /api/v3/devices/{device_id}` | 参数:`device_id` | +| `/v1/workphone/screenshot` | POST | `POST /api/v3/devices/{device_id}/screenshot` | 参数:`device_id` | +| `/v1/workphone/ai/status` | GET | `GET /api/v3/devices/{device_id}/ai/status` | ✅ 已注册 | +| `/v1/workphone/ai/task` | POST | `POST /api/v3/devices/{device_id}/ai/task` | ✅ 已注册 | +| `/v1/workphone/ai/standing-order` | POST | `POST /api/v3/devices/{device_id}/ai/standing-order` | ✅ 已注册 | +| `/v1/workphone/ai/execute` | POST | `POST /api/v3/devices/{device_id}/ai/execute` | ✅ 已注册 | + +前端定义见:`cunkebao_v3/Cunkebao/src/pages/mobile/mine/workphone/api.ts` + +--- + +## 四、WorkPhoneSDK.php 方法 → SDK 接口(已封装 40+) + +### 4.1 消息 + +| PHP 方法 | SDK 路径 | 核心参数 | +|----------|----------|----------| +| `sendMessage()` | `POST /api/v3/message/send` | device_id, platform, to_id, content, msg_type | +| `getMessages()` | `POST /api/v3/message/list` | device_id, platform, conversation_id, limit | +| `batchSendMessage()` | `POST /api/v3/message/batch-send` | device_id, platform, to_ids[], content, interval | +| `replyComment()` | `POST /api/v3/comment/reply` | device_id, platform, comment_id, content | + +### 4.2 好友 / 通讯录 + +| PHP 方法 | SDK 路径 | 核心参数 | +|----------|----------|----------| +| `addFriend()` | `POST /api/v3/friend/add` | device_id, platform, search_key, verify_msg | +| `acceptFriend()` | `POST /api/v3/friend/accept` | device_id, platform, user_id | +| `setFriendRemark()` | `POST /api/v3/friend/set-remark` | device_id, platform, user_id, remark | +| `deleteFriend()` | `POST /api/v3/friend/delete` | device_id, platform, user_id | +| `batchAddFriend()` | `POST /api/v3/friend/batch-add` | device_id, platform, targets[] | +| `getContacts()` | `GET /api/v3/contacts` | device_id, platform, limit | + +### 4.3 群聊 + +| PHP 方法 | SDK 路径 | +|----------|----------| +| `createGroup()` | `POST /api/v3/group/create` | +| `inviteToGroup()` | `POST /api/v3/group/invite` | +| `removeFromGroup()` | `POST /api/v3/group/remove` | +| `setGroupNotice()` | `POST /api/v3/group/set-notice` | +| `setGroupName()` | `POST /api/v3/group/set-name` | +| `sendGroupMessage()` | `POST /api/v3/group/send-message` | +| `setGroupWelcome()` | `POST /api/v3/group/set-welcome` | +| `getGroups()` | `GET /api/v3/group/list` | +| `getGroupMembers()` | `GET /api/v3/group/members` | + +### 4.4 标签 + +| PHP 方法 | SDK 路径 | +|----------|----------| +| `addTag()` / `removeTag()` / `createTag()` / `deleteTag()` | `/api/v3/tag/*` | +| `getTags()` | `GET /api/v3/tag/list` | +| `getUsersByTag()` | `POST /api/v3/tag/users` | + +### 4.5 朋友圈 + +| PHP 方法 | SDK 路径 | +|----------|----------| +| `postMoments()` | `POST /api/v3/moments/post` | +| `likeMoments()` | `POST /api/v3/moments/like` | +| `commentMoments()` | `POST /api/v3/moments/comment` | +| `getMoments()` | `POST /api/v3/moments/list` | + +### 4.6 设备 / Agent / UI + +| PHP 方法 | SDK 路径 | +|----------|----------| +| `getDevices()` | `GET /api/v3/devices` | +| `getDevice()` | `GET /api/v3/devices/{id}` | +| `screenshot()` | `POST /api/v3/devices/{id}/screenshot` | +| `getUiTree()` | `GET /api/v3/devices/{id}/ui-tree` | +| `click()` / `clickText()` / `input()` / `swipe()` | `POST /api/v3/devices/{id}/click*` | +| `executeTask()` | `POST /api/v3/agent/execute` | +| `getAgentStatus()` | `GET /api/v3/agent/status/{id}` | +| `stopAgent()` | `POST /api/v3/agent/stop/{id}` | +| `getAIBrainStatus()` | `GET /api/v3/devices/{id}/ai/status` | +| `pushAITask()` | `POST /api/v3/devices/{id}/ai/task` | +| `pushAIStandingOrder()` | `POST /api/v3/devices/{id}/ai/standing-order` | +| `executeAITask()` | `POST /api/v3/devices/{id}/ai/execute` | +| `healthCheck()` | `GET /health` | + +### 4.7 平台快捷方法 + +| PHP 方法 | 等价于 | +|----------|--------| +| `wechatSend()` | `sendMessage(..., 'wechat', ...)` | +| `douyinSend()` | platform=`douyin` | +| `xhsSend()` | platform=`xhs` | +| `xianyuSend()` | platform=`xianyu` | +| `soulSend()` | platform=`soul` | + +--- + +## 五、线索闭环(存客宝专用 SDK 路由) + +| 场景 | SDK 路径 | 触发方 | +|------|----------|--------| +| 配置 CKB | `POST/GET /api/v3/cunke-bao/config` | 运维 / 存客宝后台 | +| 手动线索 | `POST /api/v3/cunke-bao/report-lead` | 场景计划 / 测试 | +| 通讯录同步 | `POST /api/v3/cunke-bao/batch-contacts` | Hook / 定时任务 | +| 新好友 | `POST /api/v3/cunke-bao/hook/friend-add` | Frida Agent | +| 群变动 | `POST /api/v3/cunke-bao/hook/group-change` | Frida Agent | + +签名与字段详见 [存客宝对接规范.md](存客宝对接规范.md)。 + +--- + +## 六、BFF 路由清单(7 条,已全部注册) + +| 前端 api.ts | BFF 路由 | SDK 目标 | 状态 | +|-------------|----------|----------|------| +| `fetchWorkPhoneStatus` | `GET /v1/workphone/status` | workbench + devices | ✅ | +| `fetchWorkPhoneDevice` | `GET /v1/workphone/device` | `GET /api/v3/devices/{id}` | ✅ | +| `fetchWorkPhoneScreenshot` | `POST /v1/workphone/screenshot` | screenshot | ✅ | +| `fetchAIBrainStatus` | `GET /v1/workphone/ai/status` | `GET /api/v3/devices/{id}/ai/status` | ✅ | +| `pushAITask` | `POST /v1/workphone/ai/task` | `POST .../ai/task` | ✅ | +| `pushAIStandingOrder` | `POST /v1/workphone/ai/standing-order` | standing-order | ✅ | +| `executeAITask` | `POST /v1/workphone/ai/execute` | ai/execute | ✅ | + +代码:`cunkebao_v3/Server/application/cunkebao/config/route.php` · `GetWorkPhoneStatusController.php` · `WorkPhoneSDK.php` + +--- + +## 七、场景计划常用 SDK 接口速查 + +| 存客宝业务 | 推荐 SDK 接口 | +|------------|---------------| +| 场景群发消息 | `POST /api/v3/message/batch-send` | +| 加好友计划 | `POST /api/v3/friend/batch-add` | +| 群欢迎语 | `POST /api/v3/group/set-welcome` | +| 朋友圈营销 | `POST /api/v3/moments/post` | +| 标签分流 | `POST /api/v3/tag/add` + `GET /api/v3/tag/users` | +| 新好友进流量池 | Hook → `/api/v3/cunke-bao/hook/friend-add` | + +--- + +## 八、相关文档 + +- [工作手机API全量接口目录.md](../01-规范与统一层/工作手机API全量接口目录.md) +- [存客宝对接规范.md](存客宝对接规范.md) +- [外部对接网关接口说明.md](外部对接网关接口说明.md) +- [存客宝对接架构图.html](../05-交互图/存客宝对接架构图.html) + +--- + +## 九、联调验收(curl 快测) + +**SDK 直连**(本机 SDK 已启动时): + +```bash +# 健康检查 +curl -s http://127.0.0.1:8899/health + +# 工作台总览(BFF status 优先拉此接口) +curl -s http://127.0.0.1:8899/api/v3/workbench/overview + +# AI Brain 状态(替换 {device_id}) +curl -s http://127.0.0.1:8899/api/v3/devices/{device_id}/ai/status + +# 推送 AI 任务 +curl -s -X POST http://127.0.0.1:8899/api/v3/devices/{device_id}/ai/task \ + -H 'Content-Type: application/json' \ + -d '{"instruction":"检查微信未读","priority":5}' +``` + +**一键冒烟脚本**:`开发文档/6、测试/scripts/workphone_bff_smoke.sh` + +**2026-05-24 实测**:SDK healthy,2 台 WS 在线;`/ai/status` 与 `/ai/task` 返回 200。 + +--- + +## 十、场景联调示例(curl) + +将 `{device_id}`、`{to_id}` 替换为真机值。Base:`http://127.0.0.1:8899` + +### 10.1 场景群发消息 + +```bash +curl -s -X POST http://127.0.0.1:8899/api/v3/message/batch-send \ + -H 'Content-Type: application/json' \ + -d '{ + "device_id": "{device_id}", + "platform": "wechat", + "to_ids": ["好友A", "好友B"], + "content": "【存客宝】活动通知:今晚 8 点直播", + "interval": 3 + }' +``` + +### 10.2 批量加好友 + +```bash +curl -s -X POST http://127.0.0.1:8899/api/v3/friend/batch-add \ + -H 'Content-Type: application/json' \ + -d '{ + "device_id": "{device_id}", + "platform": "wechat", + "user_ids": ["wxid_aaa", "wxid_bbb"], + "message": "你好,通过一下", + "interval": 8 + }' +``` + +### 10.3 群欢迎语 + +```bash +curl -s -X POST http://127.0.0.1:8899/api/v3/group/set-welcome \ + -H 'Content-Type: application/json' \ + -d '{ + "device_id": "{device_id}", + "platform": "wechat", + "group_id": "{group_id}", + "welcome_text": "欢迎加入,回复「1」领资料" + }' +``` + +### 10.4 新好友 → 存客宝线索 + +```bash +curl -s -X POST http://127.0.0.1:8899/api/v3/cunke-bao/hook/friend-add \ + -H 'Content-Type: application/json' \ + -d '{ + "device_id": "{device_id}", + "wechat_id": "wxid_newfriend", + "nickname": "张三", + "source": "微信添加" + }' +``` + +### 10.5 PHP / TS 调用 + +```php +// cunkebao_v3 WorkPhoneSDK.php 或 sdk/php-sdk/WorkPhoneClient.php +$sdk->sendMessage($deviceId, 'wechat', $toId, '你好'); +$sdk->pushAITask($deviceId, '检查未读并汇总', 5); +``` + +```typescript +// sdk/typescript-sdk +await sdk.batchSendMessage({ deviceId, platform: 'wechat', toIds: ['A','B'], content: '...' }); +await sdk.pushAITask(deviceId, '检查微信未读', 5); +``` + +**接口真源**:[工作手机API全量接口目录.md](../01-规范与统一层/工作手机API全量接口目录.md) diff --git a/开发文档/5、接口/04-OpenAPI/README.md b/开发文档/5、接口/04-OpenAPI/README.md index 7ee8b402a6..c74aadf8e0 100644 --- a/开发文档/5、接口/04-OpenAPI/README.md +++ b/开发文档/5、接口/04-OpenAPI/README.md @@ -6,4 +6,5 @@ obsidian-color: "#455A64" | 文件 | 说明 | |------|------| -| [openapi_v3.0.json](openapi_v3.0.json) | v3.0 机器可读契约;Hub `/docs` 同步 | +| [openapi_v3.0.json](openapi_v3.0.json) | v3.0 机器可读契约(**315 paths**,2026-05-24 从 main.py 重新导出) | +| [routes_snapshot.json](routes_snapshot.json) | 328 条 HTTP 路由扁平快照(含系统页) | diff --git a/开发文档/5、接口/04-OpenAPI/openapi_v3.0.json b/开发文档/5、接口/04-OpenAPI/openapi_v3.0.json index 69ac09a1ff..f24471889a 100644 --- a/开发文档/5、接口/04-OpenAPI/openapi_v3.0.json +++ b/开发文档/5、接口/04-OpenAPI/openapi_v3.0.json @@ -1,11251 +1,18569 @@ { - "openapi": "3.1.0", - "info": { - "title": "\u673a\u64ce v3.0 \u00b7 \u5de5\u4f5c\u624b\u673aSDK API", - "description": "\n## \u5de5\u4f5c\u624b\u673aSDK \u2014 \u5fae\u4fe1\u5168\u529f\u80fd\u63a7\u5236\u63a5\u53e3\n\n\u901a\u8fc7 ADB UI \u81ea\u52a8\u5316\u540e\u7aef\u9759\u9ed8\u63a7\u5236 Android \u624b\u673a\u4e0a\u7684\u5fae\u4fe1\uff0c**\u65e0\u9700 Root**\u3002\n\n### \u6838\u5fc3\u80fd\u529b\n- **98 \u4e2a API \u7aef\u70b9**\uff0c\u8986\u76d6\u5fae\u4fe1\u5168\u90e8\u529f\u80fd\n- **96 \u4e2a\u5f15\u64ce\u65b9\u6cd5**\uff08WeChatADBEngine\uff09\n- **23 \u4e2a\u529f\u80fd\u6a21\u5757**\uff08\u6d88\u606f/\u597d\u53cb/\u7fa4\u804a/\u652f\u4ed8/\u89e3\u5c01/\u89c6\u9891\u53f7/\u626b\u4e00\u626b...\uff09\n- **\u5bfc\u822a\u7f13\u5b58\u7cfb\u7edf**\uff1a\u9996\u6b21\u5f55\u5236\u5750\u6807\uff0c\u540e\u7eed\u514d UI dump\n- **\u64cd\u4f5c\u65e5\u5fd7**\uff1a\u6bcf\u6b21\u64cd\u4f5c\u81ea\u52a8\u8bb0\u5f55\u6b65\u9aa4/\u8017\u65f6/\u7ed3\u679c\n- **\u5bb9\u9519\u673a\u5236**\uff1a\u81ea\u52a8\u91cd\u8bd5 3 \u6b21 + \u72b6\u6001\u6062\u590d\n\n### \u652f\u6301\u8bbe\u5907\n- Redmi Note 13 5G (Android 13, 1080\u00d72400)\n- \u5fae\u4fe1 8.0.56\n\n### \u8c03\u7528\u65b9\u5f0f\n```\nPOST http://{\u670d\u52a1\u5668IP}:8899/api/v3/message/send\nContent-Type: application/json\n\n{\n \"device_id\": \"xgfe65eimrrofyws\",\n \"platform\": \"wechat\",\n \"to_id\": \"\u597d\u53cb\u6635\u79f0\",\n \"content\": \"\u4f60\u597d\"\n}\n```\n\n### \u516c\u5171\u53c2\u6570\n| \u53c2\u6570 | \u7c7b\u578b | \u5fc5\u586b | \u8bf4\u660e |\n|------|------|------|------|\n| device_id | string | \u2705 | ADB \u8bbe\u5907\u5e8f\u5217\u53f7 |\n| platform | string | \u2705 | \u56fa\u5b9a `wechat` |\n", - "version": "3.0.0" - }, - "paths": { - "/api/v3/devices": { - "get": { - "tags": [ - "\u8bbe\u5907\u7ba1\u7406" - ], - "summary": "Get Devices", - "description": "\u83b7\u53d6\u6240\u6709\u8bbe\u5907\u5217\u8868\uff08\u878d\u5408 WebSocket + ADB + DB\uff09", - "operationId": "get_devices_api_v3_devices_get", - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Get Devices Api V3 Devices Get" - } - } - } - } - } - } - }, - "/api/v3/devices/{device_id}": { - "get": { - "tags": [ - "\u8bbe\u5907\u7ba1\u7406" - ], - "summary": "Get Device", - "description": "\u83b7\u53d6\u8bbe\u5907\u8be6\u60c5\uff08\u652f\u6301 WebSocket / ADB / DB\uff09", - "operationId": "get_device_api_v3_devices__device_id__get", - "parameters": [ - { - "name": "device_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Get Device Api V3 Devices Device Id Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/devices/{device_id}/heartbeat": { - "get": { - "tags": [ - "\u8bbe\u5907\u7ba1\u7406" - ], - "summary": "Get Device Heartbeat", - "description": "\u67e5\u8be2\u8bbe\u5907\u5fc3\u8df3\u72b6\u6001", - "operationId": "get_device_heartbeat_api_v3_devices__device_id__heartbeat_get", - "parameters": [ - { - "name": "device_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Get Device Heartbeat Api V3 Devices Device Id Heartbeat Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/devices/{device_id}/heartbeat/config": { - "post": { - "tags": [ - "\u8bbe\u5907\u7ba1\u7406" - ], - "summary": "Set Device Heartbeat", - "description": "\u4e0b\u53d1\u8bbe\u5907\u5fc3\u8df3\u914d\u7f6e\uff085-120 \u79d2\uff09", - "operationId": "set_device_heartbeat_api_v3_devices__device_id__heartbeat_config_post", - "parameters": [ - { - "name": "device_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HeartbeatConfigRequest" - } - } - } - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Set Device Heartbeat Api V3 Devices Device Id Heartbeat Config Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/devices/{device_id}/screenshot": { - "post": { - "tags": [ - "\u8bbe\u5907\u7ba1\u7406" - ], - "summary": "Screenshot", - "description": "\u83b7\u53d6\u8bbe\u5907\u622a\u56fe", - "operationId": "screenshot_api_v3_devices__device_id__screenshot_post", - "parameters": [ - { - "name": "device_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Screenshot Api V3 Devices Device Id Screenshot Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/devices/{device_id}/click": { - "post": { - "tags": [ - "\u8bbe\u5907\u7ba1\u7406" - ], - "summary": "Click", - "description": "\u70b9\u51fb\u5750\u6807", - "operationId": "click_api_v3_devices__device_id__click_post", - "parameters": [ - { - "name": "device_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ClickRequest" - } - } - } - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Click Api V3 Devices Device Id Click Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/devices/{device_id}/click-text": { - "post": { - "tags": [ - "\u8bbe\u5907\u7ba1\u7406" - ], - "summary": "Click Text", - "description": "\u70b9\u51fb\u6587\u5b57", - "operationId": "click_text_api_v3_devices__device_id__click_text_post", - "parameters": [ - { - "name": "device_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ClickTextRequest" - } - } - } - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Click Text Api V3 Devices Device Id Click Text Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/devices/{device_id}/input": { - "post": { - "tags": [ - "\u8bbe\u5907\u7ba1\u7406" - ], - "summary": "Input Text", - "description": "\u8f93\u5165\u6587\u5b57", - "operationId": "input_text_api_v3_devices__device_id__input_post", - "parameters": [ - { - "name": "device_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/routers__devices__InputRequest" - } - } - } - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Input Text Api V3 Devices Device Id Input Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/devices/{device_id}/swipe": { - "post": { - "tags": [ - "\u8bbe\u5907\u7ba1\u7406" - ], - "summary": "Swipe", - "description": "\u6ed1\u52a8", - "operationId": "swipe_api_v3_devices__device_id__swipe_post", - "parameters": [ - { - "name": "device_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/routers__devices__SwipeRequest" - } - } - } - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Swipe Api V3 Devices Device Id Swipe Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/devices/{device_id}/ui-tree": { - "get": { - "tags": [ - "\u8bbe\u5907\u7ba1\u7406" - ], - "summary": "Get Ui Tree", - "description": "\u83b7\u53d6UI\u6811", - "operationId": "get_ui_tree_api_v3_devices__device_id__ui_tree_get", - "parameters": [ - { - "name": "device_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Get Ui Tree Api V3 Devices Device Id Ui Tree Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/devices/{device_id}/execute": { - "post": { - "tags": [ - "\u8bbe\u5907\u7ba1\u7406" - ], - "summary": "Execute Script", - "description": "\u6267\u884c\u811a\u672c", - "operationId": "execute_script_api_v3_devices__device_id__execute_post", - "parameters": [ - { - "name": "device_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "script", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Script" - } - }, - { - "name": "action", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Action" - } - }, - { - "name": "timeout", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "default": 30, - "title": "Timeout" - } - } - ], - "requestBody": { - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "default": {}, - "title": "Params" - } - } - } - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Execute Script Api V3 Devices Device Id Execute Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/message/send": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u6d88\u606f\u7ba1\u7406" - ], - "summary": "Send Message", - "description": "\u53d1\u9001\u6d88\u606f\uff08\u7edf\u4e00\u63a5\u53e3\uff09\n\n\u81ea\u52a8\u9009\u62e9\u6700\u4f18\u901a\u9053\uff1a\n1. \u6709\u5b98\u65b9API \u2192 \u7528API\n2. \u8bbe\u5907\u5728\u7ebf \u2192 \u7528SDK\u63a7\u5236\n3. \u515c\u5e95 \u2192 \u7528AI Agent\n\n\u8d85\u65f6\uff1a\u4f7f\u7528 MESSAGE_SEND_TIMEOUT\uff08\u9ed8\u8ba460s\uff09\uff0c\u8d85\u65f6\u8fd4\u56de 200 + success=false + error=timeout", - "operationId": "send_message_api_v3_message_send_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SendMessageRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Send Message Api V3 Message Send Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/message/list": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u6d88\u606f\u7ba1\u7406" - ], - "summary": "Get Messages", - "description": "\u83b7\u53d6\u6d88\u606f\u5217\u8868", - "operationId": "get_messages_api_v3_message_list_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/GetMessagesRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Get Messages Api V3 Message List Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/message/batch-send": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u6d88\u606f\u7ba1\u7406" - ], - "summary": "Batch Send Message", - "description": "\u6279\u91cf\u53d1\u9001\u6d88\u606f\uff08\u670d\u52a1\u7aef\u9010\u6761\u4e0b\u53d1\uff0c\u95f4\u9694\u9632\u98ce\u63a7\uff0c\u5355\u6761\u8d85\u65f6\u53ef\u63a7\uff09", - "operationId": "batch_send_message_api_v3_message_batch_send_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/BatchSendMessageRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Batch Send Message Api V3 Message Batch Send Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/comment/reply": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u6d88\u606f\u7ba1\u7406" - ], - "summary": "Reply Comment", - "description": "\u56de\u590d\u8bc4\u8bba\uff08\u6296\u97f3/\u5c0f\u7ea2\u4e66\u7b49\uff09", - "operationId": "reply_comment_api_v3_comment_reply_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ReplyCommentRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Reply Comment Api V3 Comment Reply Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/friend/add": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u597d\u53cb\u7ba1\u7406" - ], - "summary": "Add Friend", - "description": "\u6dfb\u52a0\u597d\u53cb", - "operationId": "add_friend_api_v3_friend_add_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/AddFriendRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Add Friend Api V3 Friend Add Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/friend/accept": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u597d\u53cb\u7ba1\u7406" - ], - "summary": "Accept Friend", - "description": "\u901a\u8fc7\u597d\u53cb\u8bf7\u6c42", - "operationId": "accept_friend_api_v3_friend_accept_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/AcceptFriendRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Accept Friend Api V3 Friend Accept Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/friend/set-remark": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u597d\u53cb\u7ba1\u7406" - ], - "summary": "Set Friend Remark", - "description": "\u8bbe\u7f6e\u597d\u53cb\u5907\u6ce8", - "operationId": "set_friend_remark_api_v3_friend_set_remark_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SetRemarkRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Set Friend Remark Api V3 Friend Set Remark Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/friend/delete": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u597d\u53cb\u7ba1\u7406" - ], - "summary": "Delete Friend", - "description": "\u5220\u9664\u597d\u53cb", - "operationId": "delete_friend_api_v3_friend_delete_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/DeleteFriendRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Delete Friend Api V3 Friend Delete Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/friend/batch-add": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u597d\u53cb\u7ba1\u7406" - ], - "summary": "Batch Add Friend", - "description": "\u6279\u91cf\u6dfb\u52a0\u597d\u53cb", - "operationId": "batch_add_friend_api_v3_friend_batch_add_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/BatchAddFriendRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Batch Add Friend Api V3 Friend Batch Add Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/contacts": { - "get": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u597d\u53cb\u7ba1\u7406" - ], - "summary": "Get Contacts", - "description": "\u83b7\u53d6\u8054\u7cfb\u4eba\u5217\u8868", - "operationId": "get_contacts_api_v3_contacts_get", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "limit", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "default": 100, - "title": "Limit" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Get Contacts Api V3 Contacts Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/group/create": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u7fa4\u804a\u7ba1\u7406" - ], - "summary": "Create Group", - "description": "\u521b\u5efa\u7fa4\u804a", - "operationId": "create_group_api_v3_group_create_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/CreateGroupRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Create Group Api V3 Group Create Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/group/invite": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u7fa4\u804a\u7ba1\u7406" - ], - "summary": "Invite To Group", - "description": "\u9080\u8bf7\u5165\u7fa4", - "operationId": "invite_to_group_api_v3_group_invite_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/InviteToGroupRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Invite To Group Api V3 Group Invite Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/group/remove": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u7fa4\u804a\u7ba1\u7406" - ], - "summary": "Remove From Group", - "description": "\u79fb\u51fa\u7fa4\u804a", - "operationId": "remove_from_group_api_v3_group_remove_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/RemoveFromGroupRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Remove From Group Api V3 Group Remove Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/group/set-notice": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u7fa4\u804a\u7ba1\u7406" - ], - "summary": "Set Group Notice", - "description": "\u8bbe\u7f6e\u7fa4\u516c\u544a", - "operationId": "set_group_notice_api_v3_group_set_notice_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SetGroupNoticeRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Set Group Notice Api V3 Group Set Notice Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/group/set-name": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u7fa4\u804a\u7ba1\u7406" - ], - "summary": "Set Group Name", - "description": "\u8bbe\u7f6e\u7fa4\u540d", - "operationId": "set_group_name_api_v3_group_set_name_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SetGroupNameRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Set Group Name Api V3 Group Set Name Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/group/send-message": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u7fa4\u804a\u7ba1\u7406" - ], - "summary": "Send Group Message", - "description": "\u53d1\u9001\u7fa4\u6d88\u606f", - "operationId": "send_group_message_api_v3_group_send_message_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/GroupMessageRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Send Group Message Api V3 Group Send Message Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/group/set-welcome": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u7fa4\u804a\u7ba1\u7406" - ], - "summary": "Set Group Welcome", - "description": "\u8bbe\u7f6e\u7fa4\u6b22\u8fce\u8bed", - "operationId": "set_group_welcome_api_v3_group_set_welcome_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SetGroupWelcomeRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Set Group Welcome Api V3 Group Set Welcome Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/group/list": { - "get": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u7fa4\u804a\u7ba1\u7406" - ], - "summary": "Get Group List", - "description": "\u83b7\u53d6\u7fa4\u804a\u5217\u8868", - "operationId": "get_group_list_api_v3_group_list_get", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "limit", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "default": 100, - "title": "Limit" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Get Group List Api V3 Group List Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/group/members": { - "get": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u7fa4\u804a\u7ba1\u7406" - ], - "summary": "Get Group Members", - "description": "\u83b7\u53d6\u7fa4\u6210\u5458\u5217\u8868", - "operationId": "get_group_members_api_v3_group_members_get", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "group_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Group Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Get Group Members Api V3 Group Members Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/tag/add": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u6807\u7b7e\u7ba1\u7406" - ], - "summary": "Add Tag", - "description": "\u7ed9\u597d\u53cb\u6dfb\u52a0\u6807\u7b7e", - "operationId": "add_tag_api_v3_tag_add_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/AddTagRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Add Tag Api V3 Tag Add Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/tag/remove": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u6807\u7b7e\u7ba1\u7406" - ], - "summary": "Remove Tag", - "description": "\u79fb\u9664\u597d\u53cb\u6807\u7b7e", - "operationId": "remove_tag_api_v3_tag_remove_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/RemoveTagRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Remove Tag Api V3 Tag Remove Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/tag/create": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u6807\u7b7e\u7ba1\u7406" - ], - "summary": "Create Tag", - "description": "\u521b\u5efa\u6807\u7b7e", - "operationId": "create_tag_api_v3_tag_create_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/CreateTagRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Create Tag Api V3 Tag Create Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/tag/delete": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u6807\u7b7e\u7ba1\u7406" - ], - "summary": "Delete Tag", - "description": "\u5220\u9664\u6807\u7b7e", - "operationId": "delete_tag_api_v3_tag_delete_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/DeleteTagRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Delete Tag Api V3 Tag Delete Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/tag/list": { - "get": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u6807\u7b7e\u7ba1\u7406" - ], - "summary": "Get Tag List", - "description": "\u83b7\u53d6\u6807\u7b7e\u5217\u8868", - "operationId": "get_tag_list_api_v3_tag_list_get", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Get Tag List Api V3 Tag List Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/tag/users": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u6807\u7b7e\u7ba1\u7406" - ], - "summary": "Get Users By Tag", - "description": "\u6839\u636e\u6807\u7b7e\u83b7\u53d6\u597d\u53cb\u5217\u8868", - "operationId": "get_users_by_tag_api_v3_tag_users_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/GetUsersByTagRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Get Users By Tag Api V3 Tag Users Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/moments/post": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u670b\u53cb\u5708\u7ba1\u7406" - ], - "summary": "Post Moments", - "description": "\u53d1\u5e03\u670b\u53cb\u5708/\u77ac\u95f4\uff08\u7edf\u4e00\u8fd4\u56de 200\uff0c\u4e1a\u52a1\u5931\u8d25\u7528 success=false \u8868\u793a\uff0c\u907f\u514d 502\uff09", - "operationId": "post_moments_api_v3_moments_post_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PostMomentsRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Post Moments Api V3 Moments Post Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/moments/like": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u670b\u53cb\u5708\u7ba1\u7406" - ], - "summary": "Like Moments", - "description": "\u70b9\u8d5e\u670b\u53cb\u5708", - "operationId": "like_moments_api_v3_moments_like_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/LikeMomentsRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Like Moments Api V3 Moments Like Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/moments/comment": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u670b\u53cb\u5708\u7ba1\u7406" - ], - "summary": "Comment Moments", - "description": "\u8bc4\u8bba\u670b\u53cb\u5708", - "operationId": "comment_moments_api_v3_moments_comment_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/CommentMomentsRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Comment Moments Api V3 Moments Comment Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/moments/list": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u670b\u53cb\u5708\u7ba1\u7406" - ], - "summary": "Get Moments", - "description": "\u83b7\u53d6\u670b\u53cb\u5708\u5217\u8868", - "operationId": "get_moments_api_v3_moments_list_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/GetMomentsRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Get Moments Api V3 Moments List Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/message/forward": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u6d88\u606f\u7ba1\u7406" - ], - "summary": "Forward Message", - "description": "\u8f6c\u53d1\u6d88\u606f", - "operationId": "forward_message_api_v3_message_forward_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ForwardMessageRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Forward Message Api V3 Message Forward Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/message/recall": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u6d88\u606f\u7ba1\u7406" - ], - "summary": "Recall Message", - "description": "\u64a4\u56de\u6700\u8fd1\u4e00\u6761\u6d88\u606f", - "operationId": "recall_message_api_v3_message_recall_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Recall Message Api V3 Message Recall Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/message/send-card": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u6d88\u606f\u7ba1\u7406" - ], - "summary": "Send Card", - "description": "\u53d1\u9001\u540d\u7247", - "operationId": "send_card_api_v3_message_send_card_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SendCardRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Send Card Api V3 Message Send Card Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/profile/get": { - "get": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u4e2a\u4eba\u8bbe\u7f6e" - ], - "summary": "Get Profile", - "description": "\u83b7\u53d6\u5f53\u524d\u5fae\u4fe1\u8d26\u53f7\u8d44\u6599", - "operationId": "get_profile_api_v3_profile_get_get", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Get Profile Api V3 Profile Get Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/profile/set-nickname": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u4e2a\u4eba\u8bbe\u7f6e" - ], - "summary": "Set Nickname", - "description": "\u4fee\u6539\u5fae\u4fe1\u6635\u79f0", - "operationId": "set_nickname_api_v3_profile_set_nickname_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SetNicknameRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Set Nickname Api V3 Profile Set Nickname Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/profile/set-signature": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u4e2a\u4eba\u8bbe\u7f6e" - ], - "summary": "Set Signature", - "description": "\u4fee\u6539\u4e2a\u6027\u7b7e\u540d", - "operationId": "set_signature_api_v3_profile_set_signature_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SetSignatureRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Set Signature Api V3 Profile Set Signature Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/profile/set-avatar": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u4e2a\u4eba\u8bbe\u7f6e" - ], - "summary": "Set Avatar", - "description": "\u4fee\u6539\u5934\u50cf", - "operationId": "set_avatar_api_v3_profile_set_avatar_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SetAvatarRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Set Avatar Api V3 Profile Set Avatar Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/profile/set-gender": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u4e2a\u4eba\u8bbe\u7f6e" - ], - "summary": "Set Gender", - "description": "\u8bbe\u7f6e\u6027\u522b", - "operationId": "set_gender_api_v3_profile_set_gender_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SetGenderRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Set Gender Api V3 Profile Set Gender Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/profile/set-region": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u4e2a\u4eba\u8bbe\u7f6e" - ], - "summary": "Set Region", - "description": "\u8bbe\u7f6e\u5730\u533a", - "operationId": "set_region_api_v3_profile_set_region_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SetRegionRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Set Region Api V3 Profile Set Region Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/account/status": { - "get": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u8d26\u53f7\u5b89\u5168" - ], - "summary": "Check Account Status", - "description": "\u68c0\u67e5\u8d26\u53f7\u72b6\u6001", - "operationId": "check_account_status_api_v3_account_status_get", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Check Account Status Api V3 Account Status Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/account/unblock": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u8d26\u53f7\u5b89\u5168" - ], - "summary": "Unblock Account", - "description": "\u5fae\u4fe1\u89e3\u5c01", - "operationId": "unblock_account_api_v3_account_unblock_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/UnblockAccountRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Unblock Account Api V3 Account Unblock Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/account/safety-center": { - "get": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u8d26\u53f7\u5b89\u5168" - ], - "summary": "Safety Center", - "description": "\u6253\u5f00\u5fae\u4fe1\u5b89\u5168\u4e2d\u5fc3", - "operationId": "safety_center_api_v3_account_safety_center_get", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Safety Center Api V3 Account Safety Center Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/account/change-password": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u8d26\u53f7\u5b89\u5168" - ], - "summary": "Change Password", - "description": "\u4fee\u6539\u5fae\u4fe1\u5bc6\u7801", - "operationId": "change_password_api_v3_account_change_password_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ChangePasswordRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Change Password Api V3 Account Change Password Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/favorites/add": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u6536\u85cf\u7ba1\u7406" - ], - "summary": "Add Favorite", - "description": "\u6536\u85cf\u6d88\u606f", - "operationId": "add_favorite_api_v3_favorites_add_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/AddFavoriteRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Add Favorite Api V3 Favorites Add Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/favorites/list": { - "get": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u6536\u85cf\u7ba1\u7406" - ], - "summary": "Get Favorites", - "description": "\u83b7\u53d6\u6536\u85cf\u5217\u8868", - "operationId": "get_favorites_api_v3_favorites_list_get", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "limit", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "default": 20, - "title": "Limit" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Get Favorites Api V3 Favorites List Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/chat/set-top": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u804a\u5929\u8bbe\u7f6e" - ], - "summary": "Set Chat Top", - "description": "\u7f6e\u9876/\u53d6\u6d88\u7f6e\u9876\u804a\u5929", - "operationId": "set_chat_top_api_v3_chat_set_top_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ChatSettingRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Set Chat Top Api V3 Chat Set Top Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/chat/set-mute": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u804a\u5929\u8bbe\u7f6e" - ], - "summary": "Set Mute Chat", - "description": "\u6d88\u606f\u514d\u6253\u6270", - "operationId": "set_mute_chat_api_v3_chat_set_mute_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ChatSettingRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Set Mute Chat Api V3 Chat Set Mute Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/chat/clear-history": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u804a\u5929\u8bbe\u7f6e" - ], - "summary": "Clear Chat History", - "description": "\u6e05\u7a7a\u804a\u5929\u8bb0\u5f55", - "operationId": "clear_chat_history_api_v3_chat_clear_history_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "user_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "User Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Clear Chat History Api V3 Chat Clear History Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/contacts/search": { - "get": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u597d\u53cb\u7ba1\u7406" - ], - "summary": "Search Contacts", - "description": "\u641c\u7d22\u8054\u7cfb\u4eba", - "operationId": "search_contacts_api_v3_contacts_search_get", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "keyword", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Keyword" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Search Contacts Api V3 Contacts Search Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/friend/info": { - "get": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u597d\u53cb\u7ba1\u7406" - ], - "summary": "Get Friend Info", - "description": "\u83b7\u53d6\u597d\u53cb\u8be6\u7ec6\u8d44\u6599", - "operationId": "get_friend_info_api_v3_friend_info_get", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "user_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "User Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Get Friend Info Api V3 Friend Info Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/group/quit": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u7fa4\u804a\u7ba1\u7406" - ], - "summary": "Quit Group", - "description": "\u9000\u51fa\u7fa4\u804a", - "operationId": "quit_group_api_v3_group_quit_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "group_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Group Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Quit Group Api V3 Group Quit Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/moments/delete": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u670b\u53cb\u5708\u7ba1\u7406" - ], - "summary": "Delete Moments", - "description": "\u5220\u9664\u670b\u53cb\u5708", - "operationId": "delete_moments_api_v3_moments_delete_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "post_index", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "default": 0, - "title": "Post Index" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Delete Moments Api V3 Moments Delete Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/payment/red-packet": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u652f\u4ed8" - ], - "summary": "Send Red Packet", - "description": "\u53d1\u7ea2\u5305", - "operationId": "send_red_packet_api_v3_payment_red_packet_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/RedPacketRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Send Red Packet Api V3 Payment Red Packet Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/payment/transfer": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u652f\u4ed8" - ], - "summary": "Send Transfer", - "description": "\u8f6c\u8d26", - "operationId": "send_transfer_api_v3_payment_transfer_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/TransferRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Send Transfer Api V3 Payment Transfer Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/miniprogram/open": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u5c0f\u7a0b\u5e8f" - ], - "summary": "Open Mini Program", - "description": "\u6253\u5f00\u5c0f\u7a0b\u5e8f", - "operationId": "open_mini_program_api_v3_miniprogram_open_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "name", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Name" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Open Mini Program Api V3 Miniprogram Open Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/official-account/follow": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u516c\u4f17\u53f7" - ], - "summary": "Follow Official Account", - "description": "\u5173\u6ce8\u516c\u4f17\u53f7", - "operationId": "follow_official_account_api_v3_official_account_follow_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "account_name", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Account Name" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Follow Official Account Api V3 Official Account Follow Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/account/unblock-self": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u8d26\u53f7\u5b89\u5168" - ], - "summary": "Unblock Self", - "description": "\u81ea\u52a9\u89e3\u5c01", - "operationId": "unblock_self_api_v3_account_unblock_self_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Unblock Self Api V3 Account Unblock Self Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/account/unblock-appeal": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u8d26\u53f7\u5b89\u5168" - ], - "summary": "Unblock Appeal", - "description": "\u7533\u8bc9\u89e3\u5c01", - "operationId": "unblock_appeal_api_v3_account_unblock_appeal_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Unblock Appeal Api V3 Account Unblock Appeal Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/account/restrictions": { - "get": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u8d26\u53f7\u5b89\u5168" - ], - "summary": "Check Restrictions", - "description": "\u68c0\u67e5\u5f53\u524d\u529f\u80fd\u9650\u5236", - "operationId": "check_restrictions_api_v3_account_restrictions_get", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Check Restrictions Api V3 Account Restrictions Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/account/appeal-restriction": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u8d26\u53f7\u5b89\u5168" - ], - "summary": "Appeal Restriction", - "description": "\u7533\u8bc9\u529f\u80fd\u9650\u5236", - "operationId": "appeal_restriction_api_v3_account_appeal_restriction_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Appeal Restriction Api V3 Account Appeal Restriction Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/account/unblock-sms": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u8d26\u53f7\u5b89\u5168" - ], - "summary": "Unblock With Sms", - "description": "\u77ed\u4fe1\u9a8c\u8bc1\u89e3\u5c01", - "operationId": "unblock_with_sms_api_v3_account_unblock_sms_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "phone", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "", - "title": "Phone" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Unblock With Sms Api V3 Account Unblock Sms Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/video-channel/list": { - "get": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u89c6\u9891\u53f7" - ], - "summary": "Get Video List", - "description": "\u83b7\u53d6\u89c6\u9891\u53f7\u5217\u8868", - "operationId": "get_video_list_api_v3_video_channel_list_get", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "limit", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "default": 10, - "title": "Limit" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Get Video List Api V3 Video Channel List Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/video-channel/like": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u89c6\u9891\u53f7" - ], - "summary": "Like Video", - "description": "\u70b9\u8d5e\u89c6\u9891", - "operationId": "like_video_api_v3_video_channel_like_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "index", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "default": 0, - "title": "Index" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Like Video Api V3 Video Channel Like Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/video-channel/comment": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u89c6\u9891\u53f7" - ], - "summary": "Comment Video", - "description": "\u8bc4\u8bba\u89c6\u9891", - "operationId": "comment_video_api_v3_video_channel_comment_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "index", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "default": 0, - "title": "Index" - } - }, - { - "name": "comment", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "", - "title": "Comment" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Comment Video Api V3 Video Channel Comment Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/video-channel/follow": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u89c6\u9891\u53f7" - ], - "summary": "Follow Video Creator", - "description": "\u5173\u6ce8\u89c6\u9891\u53f7\u521b\u4f5c\u8005", - "operationId": "follow_video_creator_api_v3_video_channel_follow_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "index", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "default": 0, - "title": "Index" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Follow Video Creator Api V3 Video Channel Follow Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/video-channel/share": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u89c6\u9891\u53f7" - ], - "summary": "Share Video", - "description": "\u5206\u4eab\u89c6\u9891", - "operationId": "share_video_api_v3_video_channel_share_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "index", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "default": 0, - "title": "Index" - } - }, - { - "name": "to_id", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "", - "title": "To Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Share Video Api V3 Video Channel Share Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/scan/qr-code": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u626b\u4e00\u626b" - ], - "summary": "Scan Qr Code", - "description": "\u626b\u63cf\u4e8c\u7ef4\u7801", - "operationId": "scan_qr_code_api_v3_scan_qr_code_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Scan Qr Code Api V3 Scan Qr Code Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/scan/add-friend": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u626b\u4e00\u626b" - ], - "summary": "Scan Add Friend", - "description": "\u626b\u7801\u52a0\u597d\u53cb", - "operationId": "scan_add_friend_api_v3_scan_add_friend_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Scan Add Friend Api V3 Scan Add Friend Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/scan/my-qr": { - "get": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u626b\u4e00\u626b" - ], - "summary": "Show My Qr", - "description": "\u663e\u793a\u6211\u7684\u4e8c\u7ef4\u7801", - "operationId": "show_my_qr_api_v3_scan_my_qr_get", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Show My Qr Api V3 Scan My Qr Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/scan/extract-qr": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u626b\u4e00\u626b" - ], - "summary": "Extract Qr From Image", - "description": "\u4ece\u56fe\u7247\u8bc6\u522b\u4e8c\u7ef4\u7801", - "operationId": "extract_qr_from_image_api_v3_scan_extract_qr_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Extract Qr From Image Api V3 Scan Extract Qr Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/payment/code": { - "get": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u652f\u4ed8" - ], - "summary": "Show Payment Code", - "description": "\u663e\u793a\u4ed8\u6b3e\u7801", - "operationId": "show_payment_code_api_v3_payment_code_get", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Show Payment Code Api V3 Payment Code Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/payment/receive": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u652f\u4ed8" - ], - "summary": "Receive Payment", - "description": "\u6536\u6b3e", - "operationId": "receive_payment_api_v3_payment_receive_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "amount", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "", - "title": "Amount" - } - }, - { - "name": "desc", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "", - "title": "Desc" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Receive Payment Api V3 Payment Receive Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/payment/wallet": { - "get": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u652f\u4ed8" - ], - "summary": "View Wallet", - "description": "\u67e5\u770b\u94b1\u5305", - "operationId": "view_wallet_api_v3_payment_wallet_get", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response View Wallet Api V3 Payment Wallet Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/payment/transactions": { - "get": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u652f\u4ed8" - ], - "summary": "View Transactions", - "description": "\u67e5\u770b\u8d26\u5355", - "operationId": "view_transactions_api_v3_payment_transactions_get", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "limit", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "default": 20, - "title": "Limit" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response View Transactions Api V3 Payment Transactions Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/payment/receive-red-packet": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u652f\u4ed8" - ], - "summary": "Receive Red Packet", - "description": "\u9886\u53d6\u7ea2\u5305", - "operationId": "receive_red_packet_api_v3_payment_receive_red_packet_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "from_id", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "", - "title": "From Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Receive Red Packet Api V3 Payment Receive Red Packet Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/call/voice": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u901a\u8bdd" - ], - "summary": "Voice Call", - "description": "\u8bed\u97f3\u901a\u8bdd", - "operationId": "voice_call_api_v3_call_voice_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "user_id", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "", - "title": "User Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Voice Call Api V3 Call Voice Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/call/video": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u901a\u8bdd" - ], - "summary": "Video Call", - "description": "\u89c6\u9891\u901a\u8bdd", - "operationId": "video_call_api_v3_call_video_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "user_id", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "", - "title": "User Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Video Call Api V3 Call Video Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/mass-send": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u7fa4\u53d1\u52a9\u624b" - ], - "summary": "Mass Send", - "description": "\u7fa4\u53d1\u6d88\u606f", - "operationId": "mass_send_api_v3_mass_send_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/MassSendRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Mass Send Api V3 Mass Send Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/search/wechat": { - "get": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u641c\u4e00\u641c" - ], - "summary": "Wechat Search", - "description": "\u641c\u4e00\u641c", - "operationId": "wechat_search_api_v3_search_wechat_get", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "keyword", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "", - "title": "Keyword" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Wechat Search Api V3 Search Wechat Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/discover/top-stories": { - "get": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u770b\u4e00\u770b" - ], - "summary": "Top Stories", - "description": "\u770b\u4e00\u770b", - "operationId": "top_stories_api_v3_discover_top_stories_get", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Top Stories Api V3 Discover Top Stories Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/wechat-sport/steps": { - "get": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u5fae\u4fe1\u8fd0\u52a8" - ], - "summary": "Get Steps", - "description": "\u83b7\u53d6\u6b65\u6570", - "operationId": "get_steps_api_v3_wechat_sport_steps_get", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Get Steps Api V3 Wechat Sport Steps Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/wechat-sport/like-steps": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u5fae\u4fe1\u8fd0\u52a8" - ], - "summary": "Like Steps", - "description": "\u70b9\u8d5e\u6b65\u6570", - "operationId": "like_steps_api_v3_wechat_sport_like_steps_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "user_id", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "", - "title": "User Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Like Steps Api V3 Wechat Sport Like Steps Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/location/send": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u4f4d\u7f6e" - ], - "summary": "Send Location", - "description": "\u53d1\u9001\u4f4d\u7f6e", - "operationId": "send_location_api_v3_location_send_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "user_id", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "", - "title": "User Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Send Location Api V3 Location Send Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/location/share-realtime": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u4f4d\u7f6e" - ], - "summary": "Share Real Time Location", - "description": "\u5171\u4eab\u5b9e\u65f6\u4f4d\u7f6e", - "operationId": "share_real_time_location_api_v3_location_share_realtime_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "user_id", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "", - "title": "User Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Share Real Time Location Api V3 Location Share Realtime Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/emoji/send": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u8868\u60c5" - ], - "summary": "Send Emoji", - "description": "\u53d1\u9001\u8868\u60c5", - "operationId": "send_emoji_api_v3_emoji_send_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "user_id", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "", - "title": "User Id" - } - }, - { - "name": "emoji_name", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "", - "title": "Emoji Name" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Send Emoji Api V3 Emoji Send Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/emoji/stickers": { - "get": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u8868\u60c5" - ], - "summary": "Get Sticker List", - "description": "\u83b7\u53d6\u8868\u60c5\u5305\u5217\u8868", - "operationId": "get_sticker_list_api_v3_emoji_stickers_get", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Get Sticker List Api V3 Emoji Stickers Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/moments/set-cover": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u670b\u53cb\u5708\u7ba1\u7406" - ], - "summary": "Set Moments Cover", - "description": "\u8bbe\u7f6e\u670b\u53cb\u5708\u5c01\u9762", - "operationId": "set_moments_cover_api_v3_moments_set_cover_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Set Moments Cover Api V3 Moments Set Cover Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/moments/set-privacy": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u670b\u53cb\u5708\u7ba1\u7406" - ], - "summary": "Set Moments Privacy", - "description": "\u8bbe\u7f6e\u670b\u53cb\u5708\u53ef\u89c1\u5929\u6570", - "operationId": "set_moments_privacy_api_v3_moments_set_privacy_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "days", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "default": 180, - "title": "Days" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Set Moments Privacy Api V3 Moments Set Privacy Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/moments/share-link": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u670b\u53cb\u5708\u7ba1\u7406" - ], - "summary": "Share Link To Moments", - "description": "\u5206\u4eab\u94fe\u63a5\u5230\u670b\u53cb\u5708", - "operationId": "share_link_to_moments_api_v3_moments_share_link_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "url", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "", - "title": "Url" - } - }, - { - "name": "title", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "", - "title": "Title" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Share Link To Moments Api V3 Moments Share Link Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/message/voice": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u6d88\u606f\u7ba1\u7406" - ], - "summary": "Send Voice Message", - "description": "\u53d1\u9001\u8bed\u97f3\u6d88\u606f", - "operationId": "send_voice_message_api_v3_message_voice_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "user_id", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "", - "title": "User Id" - } - }, - { - "name": "duration", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "default": 3, - "title": "Duration" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Send Voice Message Api V3 Message Voice Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/file/send": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u6587\u4ef6\u7ba1\u7406" - ], - "summary": "Send File", - "description": "\u53d1\u9001\u6587\u4ef6", - "operationId": "send_file_api_v3_file_send_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "user_id", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "", - "title": "User Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Send File Api V3 File Send Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/file/download": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u6587\u4ef6\u7ba1\u7406" - ], - "summary": "Download File", - "description": "\u4e0b\u8f7d\u6587\u4ef6", - "operationId": "download_file_api_v3_file_download_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "user_id", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "", - "title": "User Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Download File Api V3 File Download Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/settings/do-not-disturb": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u8bbe\u7f6e" - ], - "summary": "Toggle Dnd", - "description": "\u52ff\u6270\u6a21\u5f0f", - "operationId": "toggle_dnd_api_v3_settings_do_not_disturb_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - }, - { - "name": "enable", - "in": "query", - "required": false, - "schema": { - "type": "boolean", - "default": true, - "title": "Enable" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Toggle Dnd Api V3 Settings Do Not Disturb Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/settings/clear-cache": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u8bbe\u7f6e" - ], - "summary": "Clear Cache", - "description": "\u6e05\u7406\u7f13\u5b58", - "operationId": "clear_cache_api_v3_settings_clear_cache_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Clear Cache Api V3 Settings Clear Cache Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/settings/check-update": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u8bbe\u7f6e" - ], - "summary": "Check Update", - "description": "\u68c0\u67e5\u66f4\u65b0", - "operationId": "check_update_api_v3_settings_check_update_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Check Update Api V3 Settings Check Update Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/settings/logout": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u8bbe\u7f6e" - ], - "summary": "Logout", - "description": "\u9000\u51fa\u767b\u5f55", - "operationId": "logout_api_v3_settings_logout_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Logout Api V3 Settings Logout Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/settings/switch-account": { - "post": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3", - "\u8bbe\u7f6e" - ], - "summary": "Switch Account", - "description": "\u5207\u6362\u8d26\u53f7", - "operationId": "switch_account_api_v3_settings_switch_account_post", - "parameters": [ - { - "name": "device_id", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": true, - "schema": { - "$ref": "#/components/schemas/Platform" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Switch Account Api V3 Settings Switch Account Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/anti-ban/dashboard": { - "get": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3" - ], - "summary": "Anti Ban Dashboard", - "description": "\u9632\u5c01\u98ce\u63a7\u4e2d\u5fc3\uff1a\u6c47\u603b\u5168\u5c40\u9650\u6d41/\u8d26\u53f7\u751f\u547d\u5468\u671f/\u6307\u7eb9\u78b0\u649e\u72b6\u6001", - "operationId": "anti_ban_dashboard_api_v3_anti_ban_dashboard_get", - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - } - } - } - }, - "/api/v3/anti-ban/device/{device_id}": { - "get": { - "tags": [ - "\u7edf\u4e00\u63a5\u53e3" - ], - "summary": "Anti Ban Device Detail", - "description": "\u5355\u8bbe\u5907\u9632\u5c01\u8be6\u60c5", - "operationId": "anti_ban_device_detail_api_v3_anti_ban_device__device_id__get", - "parameters": [ - { - "name": "device_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/agent/execute": { - "post": { - "tags": [ - "AI Agent" - ], - "summary": "Execute Task", - "description": "\u6267\u884c\u81ea\u7136\u8bed\u8a00\u4efb\u52a1\uff08\u81ea\u52a8\u9009\u62e9 WebSocket Agent \u6216 ADB \u76f4\u8fde\u6a21\u5f0f\uff09\n\n\u793a\u4f8b\u4efb\u52a1\uff1a\n- \"\u6253\u5f00\u5fae\u4fe1\"\n- \"\u56de\u4e3b\u9875\"\n- \"\u70b9\u51fb \u53d1\u73b0\"\n- \"\u8f93\u5165 \u4f60\u597d\"", - "operationId": "execute_task_api_v3_agent_execute_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ExecuteTaskRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Execute Task Api V3 Agent Execute Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/agent/status/{device_id}": { - "get": { - "tags": [ - "AI Agent" - ], - "summary": "Get Agent Status", - "description": "\u83b7\u53d6Agent\u72b6\u6001", - "operationId": "get_agent_status_api_v3_agent_status__device_id__get", - "parameters": [ - { - "name": "device_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Get Agent Status Api V3 Agent Status Device Id Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/agent/stop/{device_id}": { - "post": { - "tags": [ - "AI Agent" - ], - "summary": "Stop Agent", - "description": "\u505c\u6b62\u6b63\u5728\u6267\u884c\u7684Agent\u4efb\u52a1", - "operationId": "stop_agent_api_v3_agent_stop__device_id__post", - "parameters": [ - { - "name": "device_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Stop Agent Api V3 Agent Stop Device Id Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/ai/status": { - "get": { - "tags": [ - "AI Agent" - ], - "summary": "Ai Status", - "description": "\u83b7\u53d6 AI \u5f15\u64ce\u72b6\u6001", - "operationId": "ai_status_api_v3_ai_status_get", - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Ai Status Api V3 Ai Status Get" - } - } - } - } - } - } - }, - "/api/v3/ai/chat": { - "post": { - "tags": [ - "AI Agent" - ], - "summary": "Ai Chat", - "description": "AI \u5bf9\u8bdd\u63a7\u5236\u624b\u673a \u2014\u2014 \u6838\u5fc3\u7aef\u70b9\n\u7528\u6237\u8f93\u5165\u81ea\u7136\u8bed\u8a00\uff0cAI \u8fd4\u56de\u5e76\u6267\u884c\u64cd\u4f5c", - "operationId": "ai_chat_api_v3_ai_chat_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/AIChatRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Ai Chat Api V3 Ai Chat Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/v1/chat/completions": { - "post": { - "tags": [ - "AI Agent" - ], - "summary": "Openai Proxy", - "description": "OpenAI \u517c\u5bb9\u7aef\u70b9 \u2014\u2014 \u4ee3\u7406\u5230\u672c\u5730 Ollama\nOpenClaw \u53ef\u4ee5\u914d\u7f6e baseUrl \u6307\u5411\u8fd9\u91cc", - "operationId": "openai_proxy_api_v3_v1_chat_completions_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Request" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Openai Proxy Api V3 V1 Chat Completions Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/adb/devices": { - "get": { - "tags": [ - "ADB\u8bbe\u5907\u63a7\u5236", - "ADB\u8bbe\u5907\u63a7\u5236" - ], - "summary": "List Devices", - "description": "\u83b7\u53d6\u6240\u6709ADB\u8bbe\u5907", - "operationId": "list_devices_api_v3_adb_devices_get", - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - } - } - } - }, - "/api/v3/adb/scan": { - "post": { - "tags": [ - "ADB\u8bbe\u5907\u63a7\u5236", - "ADB\u8bbe\u5907\u63a7\u5236" - ], - "summary": "Scan Devices", - "description": "\u626b\u63cf\u8bbe\u5907", - "operationId": "scan_devices_api_v3_adb_scan_post", - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - } - } - } - }, - "/api/v3/adb/devices/{serial}": { - "get": { - "tags": [ - "ADB\u8bbe\u5907\u63a7\u5236", - "ADB\u8bbe\u5907\u63a7\u5236" - ], - "summary": "Get Device Info", - "description": "\u83b7\u53d6\u8bbe\u5907\u8be6\u60c5", - "operationId": "get_device_info_api_v3_adb_devices__serial__get", - "parameters": [ - { - "name": "serial", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Serial" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/adb/devices/{serial}/screenshot": { - "post": { - "tags": [ - "ADB\u8bbe\u5907\u63a7\u5236", - "ADB\u8bbe\u5907\u63a7\u5236" - ], - "summary": "Screenshot", - "description": "\u622a\u56fe", - "operationId": "screenshot_api_v3_adb_devices__serial__screenshot_post", - "parameters": [ - { - "name": "serial", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Serial" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/adb/devices/{serial}/click": { - "post": { - "tags": [ - "ADB\u8bbe\u5907\u63a7\u5236", - "ADB\u8bbe\u5907\u63a7\u5236" - ], - "summary": "Click", - "description": "\u70b9\u51fb\u5750\u6807", - "operationId": "click_api_v3_adb_devices__serial__click_post", - "parameters": [ - { - "name": "serial", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Serial" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/routers__adb__ClickRequest" - } - } - } - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/adb/devices/{serial}/click-text": { - "post": { - "tags": [ - "ADB\u8bbe\u5907\u63a7\u5236", - "ADB\u8bbe\u5907\u63a7\u5236" - ], - "summary": "Click Text", - "description": "\u70b9\u51fb\u6587\u5b57", - "operationId": "click_text_api_v3_adb_devices__serial__click_text_post", - "parameters": [ - { - "name": "serial", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Serial" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/routers__adb__ClickTextRequest" - } - } - } - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/adb/devices/{serial}/input": { - "post": { - "tags": [ - "ADB\u8bbe\u5907\u63a7\u5236", - "ADB\u8bbe\u5907\u63a7\u5236" - ], - "summary": "Input Text", - "description": "\u8f93\u5165\u6587\u5b57", - "operationId": "input_text_api_v3_adb_devices__serial__input_post", - "parameters": [ - { - "name": "serial", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Serial" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/InputRequest" - } - } - } - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/adb/devices/{serial}/swipe": { - "post": { - "tags": [ - "ADB\u8bbe\u5907\u63a7\u5236", - "ADB\u8bbe\u5907\u63a7\u5236" - ], - "summary": "Swipe", - "description": "\u6ed1\u52a8", - "operationId": "swipe_api_v3_adb_devices__serial__swipe_post", - "parameters": [ - { - "name": "serial", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Serial" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SwipeRequest" - } - } - } - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/adb/devices/{serial}/key": { - "post": { - "tags": [ - "ADB\u8bbe\u5907\u63a7\u5236", - "ADB\u8bbe\u5907\u63a7\u5236" - ], - "summary": "Press Key", - "description": "\u6309\u952e", - "operationId": "press_key_api_v3_adb_devices__serial__key_post", - "parameters": [ - { - "name": "serial", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Serial" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/KeyRequest" - } - } - } - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/adb/devices/{serial}/app/start": { - "post": { - "tags": [ - "ADB\u8bbe\u5907\u63a7\u5236", - "ADB\u8bbe\u5907\u63a7\u5236" - ], - "summary": "Start App", - "description": "\u542f\u52a8APP", - "operationId": "start_app_api_v3_adb_devices__serial__app_start_post", - "parameters": [ - { - "name": "serial", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Serial" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/AppRequest" - } - } - } - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/adb/devices/{serial}/app/stop": { - "post": { - "tags": [ - "ADB\u8bbe\u5907\u63a7\u5236", - "ADB\u8bbe\u5907\u63a7\u5236" - ], - "summary": "Stop App", - "description": "\u505c\u6b62APP", - "operationId": "stop_app_api_v3_adb_devices__serial__app_stop_post", - "parameters": [ - { - "name": "serial", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Serial" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/AppRequest" - } - } - } - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/adb/devices/{serial}/app/current": { - "get": { - "tags": [ - "ADB\u8bbe\u5907\u63a7\u5236", - "ADB\u8bbe\u5907\u63a7\u5236" - ], - "summary": "Current App", - "description": "\u83b7\u53d6\u5f53\u524dAPP", - "operationId": "current_app_api_v3_adb_devices__serial__app_current_get", - "parameters": [ - { - "name": "serial", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Serial" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/adb/devices/{serial}/app/list": { - "get": { - "tags": [ - "ADB\u8bbe\u5907\u63a7\u5236", - "ADB\u8bbe\u5907\u63a7\u5236" - ], - "summary": "List Apps", - "description": "\u83b7\u53d6\u5df2\u5b89\u88c5APP", - "operationId": "list_apps_api_v3_adb_devices__serial__app_list_get", - "parameters": [ - { - "name": "serial", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Serial" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/adb/devices/{serial}/ui-tree": { - "get": { - "tags": [ - "ADB\u8bbe\u5907\u63a7\u5236", - "ADB\u8bbe\u5907\u63a7\u5236" - ], - "summary": "Get Ui Tree", - "description": "\u83b7\u53d6UI\u6811", - "operationId": "get_ui_tree_api_v3_adb_devices__serial__ui_tree_get", - "parameters": [ - { - "name": "serial", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Serial" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/experience/statistics": { - "get": { - "tags": [ - "\u7ecf\u9a8c\u5e93", - "\u7ecf\u9a8c\u5e93" - ], - "summary": "Get Statistics", - "description": "\u83b7\u53d6\u7ecf\u9a8c\u5e93\u7edf\u8ba1\u4fe1\u606f", - "operationId": "get_statistics_api_v3_experience_statistics_get", - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - } - } - } - }, - "/api/v3/experience/operations": { - "get": { - "tags": [ - "\u7ecf\u9a8c\u5e93", - "\u7ecf\u9a8c\u5e93" - ], - "summary": "Get Operations", - "description": "\u83b7\u53d6\u6700\u8fd1\u7684\u64cd\u4f5c\u8bb0\u5f55", - "operationId": "get_operations_api_v3_experience_operations_get", - "parameters": [ - { - "name": "limit", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "default": 100, - "title": "Limit" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/experience/operations/record": { - "post": { - "tags": [ - "\u7ecf\u9a8c\u5e93", - "\u7ecf\u9a8c\u5e93" - ], - "summary": "Record Operation", - "description": "\u8bb0\u5f55\u4e00\u6b21\u64cd\u4f5c", - "operationId": "record_operation_api_v3_experience_operations_record_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/RecordOperation" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/experience/shortcuts": { - "get": { - "tags": [ - "\u7ecf\u9a8c\u5e93", - "\u7ecf\u9a8c\u5e93" - ], - "summary": "List Shortcuts", - "description": "\u5217\u51fa\u6240\u6709\u5feb\u6377\u64cd\u4f5c", - "operationId": "list_shortcuts_api_v3_experience_shortcuts_get", - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - } - } - }, - "post": { - "tags": [ - "\u7ecf\u9a8c\u5e93", - "\u7ecf\u9a8c\u5e93" - ], - "summary": "Create Shortcut", - "description": "\u521b\u5efa\u5feb\u6377\u64cd\u4f5c", - "operationId": "create_shortcut_api_v3_experience_shortcuts_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ShortcutCreate" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/experience/shortcuts/{name}": { - "get": { - "tags": [ - "\u7ecf\u9a8c\u5e93", - "\u7ecf\u9a8c\u5e93" - ], - "summary": "Get Shortcut", - "description": "\u83b7\u53d6\u5feb\u6377\u64cd\u4f5c\u8be6\u60c5", - "operationId": "get_shortcut_api_v3_experience_shortcuts__name__get", - "parameters": [ - { - "name": "name", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Name" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/experience/shortcuts/{name}/execute/{device_id}": { - "post": { - "tags": [ - "\u7ecf\u9a8c\u5e93", - "\u7ecf\u9a8c\u5e93" - ], - "summary": "Execute Shortcut", - "description": "\u6267\u884c\u5feb\u6377\u64cd\u4f5c\n\n\u793a\u4f8b: \u6267\u884c\u5fae\u4fe1\u53d1\u6d88\u606f\nPOST /api/v3/experience/shortcuts/wechat_send_message/execute/emulator-5554\n{\n \"variables\": {\n \"contact\": \"\u5f20\u4e09\",\n \"message\": \"\u4f60\u597d\"\n }\n}", - "operationId": "execute_shortcut_api_v3_experience_shortcuts__name__execute__device_id__post", - "parameters": [ - { - "name": "name", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Name" - } - }, - { - "name": "device_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - } - ], - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ShortcutExecute" - } - } - } - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/experience/suggest/coordinates": { - "get": { - "tags": [ - "\u7ecf\u9a8c\u5e93", - "\u7ecf\u9a8c\u5e93" - ], - "summary": "Suggest Coordinates", - "description": "\u83b7\u53d6\u5750\u6807\u5efa\u8bae\n\n\u6839\u636e\u5386\u53f2\u64cd\u4f5c\u8bb0\u5f55\uff0c\u5efa\u8bae\u67d0\u4e2aAPP\u4e2d\u67d0\u4e2a\u6587\u5b57\u5143\u7d20\u7684\u5750\u6807", - "operationId": "suggest_coordinates_api_v3_experience_suggest_coordinates_get", - "parameters": [ - { - "name": "app", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "App" - } - }, - { - "name": "text", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Text" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/experience/success-rate": { - "get": { - "tags": [ - "\u7ecf\u9a8c\u5e93", - "\u7ecf\u9a8c\u5e93" - ], - "summary": "Get Success Rate", - "description": "\u83b7\u53d6\u67d0\u64cd\u4f5c\u7684\u6210\u529f\u7387", - "operationId": "get_success_rate_api_v3_experience_success_rate_get", - "parameters": [ - { - "name": "app", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "App" - } - }, - { - "name": "action", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Action" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/experience/average-duration": { - "get": { - "tags": [ - "\u7ecf\u9a8c\u5e93", - "\u7ecf\u9a8c\u5e93" - ], - "summary": "Get Average Duration", - "description": "\u83b7\u53d6\u67d0\u64cd\u4f5c\u7684\u5e73\u5747\u8017\u65f6", - "operationId": "get_average_duration_api_v3_experience_average_duration_get", - "parameters": [ - { - "name": "app", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "App" - } - }, - { - "name": "action", - "in": "query", - "required": true, - "schema": { - "type": "string", - "title": "Action" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/experience/elements": { - "get": { - "tags": [ - "\u7ecf\u9a8c\u5e93", - "\u7ecf\u9a8c\u5e93" - ], - "summary": "Get Learned Elements", - "description": "\u83b7\u53d6\u5b66\u4e60\u5230\u7684APP\u5143\u7d20", - "operationId": "get_learned_elements_api_v3_experience_elements_get", - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - } - } - } - }, - "/api/v3/experience/elements/{app}": { - "get": { - "tags": [ - "\u7ecf\u9a8c\u5e93", - "\u7ecf\u9a8c\u5e93" - ], - "summary": "Get App Elements", - "description": "\u83b7\u53d6\u67d0APP\u5b66\u4e60\u5230\u7684\u5143\u7d20", - "operationId": "get_app_elements_api_v3_experience_elements__app__get", - "parameters": [ - { - "name": "app", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "App" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/projects": { - "get": { - "tags": [ - "\u9879\u76ee\u7ba1\u7406", - "\u9879\u76ee\u7ba1\u7406" - ], - "summary": "List Projects", - "description": "\u83b7\u53d6\u6240\u6709\u9879\u76ee\u5217\u8868", - "operationId": "list_projects_api_v3_projects_get", - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - } - } - } - }, - "/api/v3/projects/{project_id}": { - "get": { - "tags": [ - "\u9879\u76ee\u7ba1\u7406", - "\u9879\u76ee\u7ba1\u7406" - ], - "summary": "Get Project", - "description": "\u83b7\u53d6\u9879\u76ee\u8be6\u60c5", - "operationId": "get_project_api_v3_projects__project_id__get", - "parameters": [ - { - "name": "project_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Project Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/projects/{project_id}/devices": { - "get": { - "tags": [ - "\u9879\u76ee\u7ba1\u7406", - "\u9879\u76ee\u7ba1\u7406" - ], - "summary": "Get Project Devices", - "description": "\u83b7\u53d6\u9879\u76ee\u4e0b\u6240\u6709\u5728\u7ebf\u8bbe\u5907", - "operationId": "get_project_devices_api_v3_projects__project_id__devices_get", - "parameters": [ - { - "name": "project_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Project Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/projects/{project_id}/broadcast": { - "post": { - "tags": [ - "\u9879\u76ee\u7ba1\u7406", - "\u9879\u76ee\u7ba1\u7406" - ], - "summary": "Broadcast Command", - "description": "\u5411\u9879\u76ee\u4e0b\u6240\u6709\u8bbe\u5907\u5e7f\u64ad\u547d\u4ee4\uff08\u4e0d\u7b49\u5f85\u54cd\u5e94\uff09\n\n\u9002\u7528\u4e8e\uff1a\u6253\u5f00APP\u3001\u53d1\u9001\u901a\u77e5\u7b49\u4e0d\u9700\u8981\u7b49\u5f85\u7ed3\u679c\u7684\u64cd\u4f5c", - "operationId": "broadcast_command_api_v3_projects__project_id__broadcast_post", - "parameters": [ - { - "name": "project_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Project Id" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ExecuteCommand" - } - } - } - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/projects/{project_id}/execute": { - "post": { - "tags": [ - "\u9879\u76ee\u7ba1\u7406", - "\u9879\u76ee\u7ba1\u7406" - ], - "summary": "Execute Command", - "description": "\u5728\u9879\u76ee\u4e0b\u6240\u6709\u8bbe\u5907\u6267\u884c\u547d\u4ee4\uff08\u7b49\u5f85\u54cd\u5e94\uff09\n\n\u9002\u7528\u4e8e\uff1a\u9700\u8981\u83b7\u53d6\u6267\u884c\u7ed3\u679c\u7684\u64cd\u4f5c", - "operationId": "execute_command_api_v3_projects__project_id__execute_post", - "parameters": [ - { - "name": "project_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Project Id" - } - }, - { - "name": "timeout", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "default": 30, - "title": "Timeout" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ExecuteCommand" - } - } - } - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/projects/{project_id}/devices/{device_id}/execute": { - "post": { - "tags": [ - "\u9879\u76ee\u7ba1\u7406", - "\u9879\u76ee\u7ba1\u7406" - ], - "summary": "Execute On Device", - "description": "\u5728\u6307\u5b9a\u8bbe\u5907\u4e0a\u6267\u884c\u547d\u4ee4", - "operationId": "execute_on_device_api_v3_projects__project_id__devices__device_id__execute_post", - "parameters": [ - { - "name": "project_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Project Id" - } - }, - { - "name": "device_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "timeout", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "default": 30, - "title": "Timeout" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ExecuteCommand" - } - } - } - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/qrcode/generate": { - "post": { - "tags": [ - "\u4e8c\u7ef4\u7801", - "\u4e8c\u7ef4\u7801" - ], - "summary": "Generate Qrcode", - "description": "\u751f\u6210\u9879\u76ee\u7ed1\u5b9a\u4e8c\u7ef4\u7801\n\n\u8bf7\u6c42\u4f53:\n{\n \"project_id\": \"project_001\",\n \"project_name\": \"\u6d4b\u8bd5\u9879\u76ee\",\n \"server\": \"ws://sdk.quwanzhi.com:8899/ws/device\"\n}\n\n\u8fd4\u56de: Base64\u7f16\u7801\u7684PNG\u56fe\u7247", - "operationId": "generate_qrcode_api_v3_qrcode_generate_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ProjectBindConfig" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/qrcode/image/{project_id}": { - "get": { - "tags": [ - "\u4e8c\u7ef4\u7801", - "\u4e8c\u7ef4\u7801" - ], - "summary": "Get Qrcode Image", - "description": "\u76f4\u63a5\u83b7\u53d6\u4e8c\u7ef4\u7801\u56fe\u7247\n\n\u793a\u4f8b: GET /api/v3/qrcode/image/project_001?project_name=\u6d4b\u8bd5\u9879\u76ee\n\n\u8fd4\u56de: PNG\u56fe\u7247", - "operationId": "get_qrcode_image_api_v3_qrcode_image__project_id__get", - "parameters": [ - { - "name": "project_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Project Id" - } - }, - { - "name": "project_name", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "", - "title": "Project Name" - } - }, - { - "name": "server", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "ws://sdk.quwanzhi.com:8899/ws/device", - "title": "Server" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/qrcode/html/{project_id}": { - "get": { - "tags": [ - "\u4e8c\u7ef4\u7801", - "\u4e8c\u7ef4\u7801" - ], - "summary": "Get Qrcode Html", - "description": "\u83b7\u53d6\u5e26\u6837\u5f0f\u7684\u4e8c\u7ef4\u7801HTML\u9875\u9762\n\n\u793a\u4f8b: GET /api/v3/qrcode/html/project_001?project_name=\u6d4b\u8bd5\u9879\u76ee\n\n\u8fd4\u56de: HTML\u9875\u9762\uff0c\u53ef\u76f4\u63a5\u6253\u5370\u6216\u5206\u4eab", - "operationId": "get_qrcode_html_api_v3_qrcode_html__project_id__get", - "parameters": [ - { - "name": "project_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Project Id" - } - }, - { - "name": "project_name", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "", - "title": "Project Name" - } - }, - { - "name": "server", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "ws://sdk.quwanzhi.com:8899/ws/device", - "title": "Server" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/voice/command": { - "post": { - "tags": [ - "\u8bed\u97f3\u63a7\u5236", - "\u8bed\u97f3\u63a7\u5236" - ], - "summary": "Voice Command", - "description": "\u5904\u7406\u8bed\u97f3\u547d\u4ee4\n\n\u63a5\u6536\u6587\u672c\u547d\u4ee4\uff0c\u89e3\u6790\u610f\u56fe\uff0c\u53ef\u9009\u62e9\u7acb\u5373\u6267\u884c\n\n\u793a\u4f8b\uff1a\nPOST /api/v3/voice/command\n{\n \"text\": \"\u6253\u5f00\u5fae\u4fe1\",\n \"device_id\": \"device_001\",\n \"execute\": true\n}", - "operationId": "voice_command_api_v3_voice_command_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/VoiceCommandRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/VoiceCommandResponse" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/voice/parse": { - "post": { - "tags": [ - "\u8bed\u97f3\u63a7\u5236", - "\u8bed\u97f3\u63a7\u5236" - ], - "summary": "Parse Command", - "description": "\u4ec5\u89e3\u6790\u547d\u4ee4\uff0c\u4e0d\u6267\u884c\n\n\u7528\u4e8e\u9884\u89c8AI\u89e3\u6790\u7ed3\u679c", - "operationId": "parse_command_api_v3_voice_parse_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/VoiceCommandRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/voice/apps": { - "get": { - "tags": [ - "\u8bed\u97f3\u63a7\u5236", - "\u8bed\u97f3\u63a7\u5236" - ], - "summary": "Get Common Apps", - "description": "\u83b7\u53d6\u5e38\u7528\u5e94\u7528\u5217\u8868\n\n\u7528\u4e8e\u8bed\u97f3\u8bc6\u522b\u63d0\u793a", - "operationId": "get_common_apps_api_v3_voice_apps_get", - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - } - } - } - }, - "/api/v3/capture/start": { - "post": { - "tags": [ - "\u6293\u5305" - ], - "summary": "Api Start Capture", - "operationId": "api_start_capture_api_v3_capture_start_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/StartCaptureRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Api Start Capture Api V3 Capture Start Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/capture/stop": { - "post": { - "tags": [ - "\u6293\u5305" - ], - "summary": "Api Stop Capture", - "operationId": "api_stop_capture_api_v3_capture_stop_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/StopCaptureRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Api Stop Capture Api V3 Capture Stop Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/capture/status/{device_id}": { - "get": { - "tags": [ - "\u6293\u5305" - ], - "summary": "Api Capture Status", - "operationId": "api_capture_status_api_v3_capture_status__device_id__get", - "parameters": [ - { - "name": "device_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Api Capture Status Api V3 Capture Status Device Id Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/capture/data/{device_id}": { - "get": { - "tags": [ - "\u6293\u5305" - ], - "summary": "Api Capture Data", - "operationId": "api_capture_data_api_v3_capture_data__device_id__get", - "parameters": [ - { - "name": "device_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "limit", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "default": 100, - "title": "Limit" - } - }, - { - "name": "since", - "in": "query", - "required": false, - "schema": { - "anyOf": [ - { - "type": "number" - }, - { - "type": "null" - } - ], - "title": "Since" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Response Api Capture Data Api V3 Capture Data Device Id Get" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/modules": { - "get": { - "tags": [ - "Hook\u6a21\u5757\u7ba1\u7406" - ], - "summary": "List Modules", - "operationId": "list_modules_api_v3_modules_get", - "parameters": [ - { - "name": "enabled", - "in": "query", - "required": false, - "schema": { - "anyOf": [ - { - "type": "boolean" - }, - { - "type": "null" - } - ], - "title": "Enabled" - } - }, - { - "name": "scope", - "in": "query", - "required": false, - "schema": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "Scope" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - }, - "post": { - "tags": [ - "Hook\u6a21\u5757\u7ba1\u7406" - ], - "summary": "Create Module", - "operationId": "create_module_api_v3_modules_post", - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ModuleUpsertRequest" - } - } - } - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/modules/{module_id}": { - "get": { - "tags": [ - "Hook\u6a21\u5757\u7ba1\u7406" - ], - "summary": "Get Module", - "operationId": "get_module_api_v3_modules__module_id__get", - "parameters": [ - { - "name": "module_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Module Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - }, - "put": { - "tags": [ - "Hook\u6a21\u5757\u7ba1\u7406" - ], - "summary": "Update Module", - "operationId": "update_module_api_v3_modules__module_id__put", - "parameters": [ - { - "name": "module_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Module Id" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ModuleUpsertRequest" - } - } - } - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - }, - "delete": { - "tags": [ - "Hook\u6a21\u5757\u7ba1\u7406" - ], - "summary": "Delete Module", - "operationId": "delete_module_api_v3_modules__module_id__delete", - "parameters": [ - { - "name": "module_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Module Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/modules/{module_id}/scope": { - "put": { - "tags": [ - "Hook\u6a21\u5757\u7ba1\u7406" - ], - "summary": "Set Module Scope", - "operationId": "set_module_scope_api_v3_modules__module_id__scope_put", - "parameters": [ - { - "name": "module_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Module Id" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ScopeUpdateRequest" - } - } - } - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/modules/{module_id}/enable": { - "post": { - "tags": [ - "Hook\u6a21\u5757\u7ba1\u7406" - ], - "summary": "Enable Module", - "operationId": "enable_module_api_v3_modules__module_id__enable_post", - "parameters": [ - { - "name": "module_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Module Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/modules/{module_id}/disable": { - "post": { - "tags": [ - "Hook\u6a21\u5757\u7ba1\u7406" - ], - "summary": "Disable Module", - "operationId": "disable_module_api_v3_modules__module_id__disable_post", - "parameters": [ - { - "name": "module_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Module Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/devices/{device_id}/modules": { - "get": { - "tags": [ - "Hook\u6a21\u5757\u7ba1\u7406" - ], - "summary": "Get Device Modules", - "operationId": "get_device_modules_api_v3_devices__device_id__modules_get", - "parameters": [ - { - "name": "device_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/devices/{device_id}/modules/reload": { - "post": { - "tags": [ - "Hook\u6a21\u5757\u7ba1\u7406" - ], - "summary": "Reload Device Modules", - "operationId": "reload_device_modules_api_v3_devices__device_id__modules_reload_post", - "parameters": [ - { - "name": "device_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ReloadDeviceModulesRequest" - } - } - } - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/devices/{device_id}/modules/{module_id}/logs": { - "get": { - "tags": [ - "Hook\u6a21\u5757\u7ba1\u7406" - ], - "summary": "Get Device Module Logs", - "operationId": "get_device_module_logs_api_v3_devices__device_id__modules__module_id__logs_get", - "parameters": [ - { - "name": "device_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Device Id" - } - }, - { - "name": "module_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Module Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/scripts": { - "get": { - "tags": [ - "Hook\u6a21\u5757\u7ba1\u7406" - ], - "summary": "List Scripts", - "operationId": "list_scripts_api_v3_scripts_get", - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - } - } - }, - "post": { - "tags": [ - "Hook\u6a21\u5757\u7ba1\u7406" - ], - "summary": "Upload Script", - "operationId": "upload_script_api_v3_scripts_post", - "parameters": [ - { - "name": "module_id", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "wechat_hook_v1", - "title": "Module Id" - } - }, - { - "name": "version", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "1.0.0", - "title": "Version" - } - }, - { - "name": "description", - "in": "query", - "required": false, - "schema": { - "type": "string", - "default": "", - "title": "Description" - } - } - ], - "requestBody": { - "required": true, - "content": { - "multipart/form-data": { - "schema": { - "$ref": "#/components/schemas/Body_upload_script_api_v3_scripts_post" - } - } - } - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/scripts/{script_id}": { - "get": { - "tags": [ - "Hook\u6a21\u5757\u7ba1\u7406" - ], - "summary": "Download Script", - "operationId": "download_script_api_v3_scripts__script_id__get", - "parameters": [ - { - "name": "script_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Script Id" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/scripts/{script_id}/deploy": { - "post": { - "tags": [ - "Hook\u6a21\u5757\u7ba1\u7406" - ], - "summary": "Deploy Script", - "operationId": "deploy_script_api_v3_scripts__script_id__deploy_post", - "parameters": [ - { - "name": "script_id", - "in": "path", - "required": true, - "schema": { - "type": "string", - "title": "Script Id" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/DeployScriptRequest" - } - } - } - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/hook/events": { - "get": { - "tags": [ - "Hook\u6a21\u5757\u7ba1\u7406" - ], - "summary": "List Hook Events", - "operationId": "list_hook_events_api_v3_hook_events_get", - "parameters": [ - { - "name": "event_type", - "in": "query", - "required": false, - "schema": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "Event Type" - } - }, - { - "name": "device_id", - "in": "query", - "required": false, - "schema": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "Device Id" - } - }, - { - "name": "platform", - "in": "query", - "required": false, - "schema": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "Platform" - } - }, - { - "name": "limit", - "in": "query", - "required": false, - "schema": { - "type": "integer", - "default": 100, - "title": "Limit" - } - } - ], - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - }, - "post": { - "tags": [ - "Hook\u6a21\u5757\u7ba1\u7406" - ], - "summary": "Ingest Hook Event", - "operationId": "ingest_hook_event_api_v3_hook_events_post", - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true, - "title": "Payload" - } - } - } - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/connection/protocol": { - "get": { - "tags": [ - "\u8fde\u63a5\u534f\u8bae" - ], - "summary": "Get Connection Protocol", - "description": "\u8fde\u63a5\u65b9\u5f0f\u534f\u8bae\uff1a\u7ed9\u524d\u7aef/\u5bf9\u63a5\u65b9\u76f4\u89c2\u770b\u7ed3\u6784\u3002", - "operationId": "get_connection_protocol_api_v3_connection_protocol_get", - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Get Connection Protocol Api V3 Connection Protocol Get" - } - } - } - } - } - } - }, - "/api/v3/connection/status": { - "get": { - "tags": [ - "\u8fde\u63a5\u534f\u8bae" - ], - "summary": "Get Connection Status", - "description": "\u5b9e\u65f6\u8fde\u63a5\u72b6\u6001\uff1a\u7528\u4e8e\u63a7\u5236\u53f0\u5c55\u793a\u3002", - "operationId": "get_connection_status_api_v3_connection_status_get", - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Get Connection Status Api V3 Connection Status Get" - } - } - } - } - } - } - }, - "/api/v3/connection/simulate/register": { - "post": { - "tags": [ - "\u8fde\u63a5\u534f\u8bae" - ], - "summary": "Simulate Register", - "description": "\u534f\u8bae\u8054\u8c03\uff1a\u6a21\u62df\u8bbe\u5907 register\uff08\u4e0d\u5efa\u7acb\u771f\u5b9e WS\uff0c\u4ec5\u5199\u5165\u72b6\u6001\u9762\u677f\uff09\u3002", - "operationId": "simulate_register_api_v3_connection_simulate_register_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SimRegisterRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Simulate Register Api V3 Connection Simulate Register Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/connection/simulate/heartbeat": { - "post": { - "tags": [ - "\u8fde\u63a5\u534f\u8bae" - ], - "summary": "Simulate Heartbeat", - "description": "\u534f\u8bae\u8054\u8c03\uff1a\u6a21\u62df\u5fc3\u8df3\u3002", - "operationId": "simulate_heartbeat_api_v3_connection_simulate_heartbeat_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SimHeartbeatRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Simulate Heartbeat Api V3 Connection Simulate Heartbeat Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/api/v3/connection/simulate/hook-event": { - "post": { - "tags": [ - "\u8fde\u63a5\u534f\u8bae" - ], - "summary": "Simulate Hook Event", - "description": "\u534f\u8bae\u8054\u8c03\uff1a\u6a21\u62df hook \u4e8b\u4ef6\u5199\u5165\u5e76\u5e7f\u64ad\u5230\u4e8b\u4ef6\u6d41\u3002", - "operationId": "simulate_hook_event_api_v3_connection_simulate_hook_event_post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SimHookEventRequest" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": { - "additionalProperties": true, - "type": "object", - "title": "Response Simulate Hook Event Api V3 Connection Simulate Hook Event Post" - } - } - } - }, - "422": { - "description": "Validation Error", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/HTTPValidationError" - } - } - } - } - } - } - }, - "/health": { - "get": { - "summary": "Health Check", - "description": "\u5065\u5eb7\u68c0\u67e5", - "operationId": "health_check_health_get", - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - } - } - } - }, - "/ready": { - "get": { - "summary": "Ready", - "description": "\u5c31\u7eea\u63a2\u9488\uff08\u90e8\u7f72/\u8d1f\u8f7d\u5747\u8861\u7528\uff09\uff1a\u8fdb\u7a0b\u5df2\u542f\u52a8\u4e14\u53ef\u63a5\u6536\u6d41\u91cf", - "operationId": "ready_ready_get", - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - } - } - } - }, - "/": { - "get": { - "summary": "Root", - "description": "\u6839\u8def\u7531 \u2192 \u63a7\u5236\u9762\u677f", - "operationId": "root__get", - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - } - } - } - }, - "/voice": { - "get": { - "summary": "Voice Control Page", - "description": "\u8bed\u97f3\u63a7\u5236\u9875\u9762", - "operationId": "voice_control_page_voice_get", - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - } - } - } - }, - "/api/v3/agent/download": { - "get": { - "summary": "Download Agent", - "description": "\u4e0b\u8f7d\u8bbe\u5907\u7aef Agent \u6253\u5305\u6587\u4ef6\uff08agent.tar.gz\uff09\n\n\u8bbe\u5907\u7aef install.sh \u4f1a\u8c03\u7528\u6b64\u63a5\u53e3\u81ea\u52a8\u4e0b\u8f7d\u4ee3\u7801\u3002\n\u5982\u679c dist/agent.tar.gz \u4e0d\u5b58\u5728\uff0c\u81ea\u52a8\u8fd0\u884c package.sh \u6253\u5305\u3002", - "operationId": "download_agent_api_v3_agent_download_get", - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - } - } - } - }, - "/install.sh": { - "get": { - "summary": "Serve Install Script", - "description": "\u63d0\u4f9b Termux \u4e00\u952e\u5b89\u88c5\u811a\u672c\n\n\u7528\u6cd5: curl -sL http://\u670d\u52a1\u5668IP:8899/install.sh | bash -s -- --server ws://\u670d\u52a1\u5668IP:8899/ws/device", - "operationId": "serve_install_script_install_sh_get", - "responses": { - "200": { - "description": "Successful Response", - "content": { - "application/json": { - "schema": {} - } - } - } - } - } + "openapi": "3.1.0", + "info": { + "title": "机擎 v3.0 · 工作手机SDK API", + "description": "\n## 工作手机SDK — 微信全功能控制接口\n\n通过 ADB UI 自动化后端静默控制 Android 手机上的微信,**无需 Root**。\n\n### 核心能力\n- **98 个 API 端点**,覆盖微信全部功能\n- **96 个引擎方法**(WeChatADBEngine)\n- **23 个功能模块**(消息/好友/群聊/支付/解封/视频号/扫一扫...)\n- **导航缓存系统**:首次录制坐标,后续免 UI dump\n- **操作日志**:每次操作自动记录步骤/耗时/结果\n- **容错机制**:自动重试 3 次 + 状态恢复\n\n### 支持设备\n- Redmi Note 13 5G (Android 13, 1080×2400)\n- 微信 8.0.56\n\n### 调用方式\n```\nPOST http://{服务器IP}:8899/api/v3/message/send\nContent-Type: application/json\n\n{\n \"device_id\": \"xgfe65eimrrofyws\",\n \"platform\": \"wechat\",\n \"to_id\": \"好友昵称\",\n \"content\": \"你好\"\n}\n```\n\n### 公共参数\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| device_id | string | ✅ | ADB 设备序列号 |\n| platform | string | ✅ | 固定 `wechat` |\n", + "version": "3.0.0" + }, + "paths": { + "/api/v3/devices": { + "get": { + "tags": [ + "设备管理" + ], + "summary": "Get Devices", + "description": "获取所有设备列表(融合 WebSocket + ADB + DB)", + "operationId": "get_devices_api_v3_devices_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Get Devices Api V3 Devices Get" + } + } + } + } } + } }, - "components": { - "schemas": { - "AIChatRequest": { - "properties": { - "message": { - "type": "string", - "title": "Message" - }, - "device_id": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "Device Id" - } - }, - "type": "object", - "required": [ - "message" - ], - "title": "AIChatRequest" - }, - "AcceptFriendRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "user_id": { - "type": "string", - "title": "User Id" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "user_id" - ], - "title": "AcceptFriendRequest", - "description": "\u901a\u8fc7\u597d\u53cb\u8bf7\u6c42" - }, - "AddFavoriteRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "content_desc": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "Content Desc" - } - }, - "type": "object", - "required": [ - "device_id", - "platform" - ], - "title": "AddFavoriteRequest" - }, - "AddFriendRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "user_id": { - "type": "string", - "title": "User Id" - }, - "message": { - "type": "string", - "title": "Message", - "default": "" - }, - "source": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "Source" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "user_id" - ], - "title": "AddFriendRequest", - "description": "\u6dfb\u52a0\u597d\u53cb\u8bf7\u6c42" - }, - "AddTagRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "user_id": { - "type": "string", - "title": "User Id" - }, - "tags": { - "items": { - "type": "string" - }, - "type": "array", - "title": "Tags" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "user_id", - "tags" - ], - "title": "AddTagRequest", - "description": "\u6dfb\u52a0\u6807\u7b7e\u8bf7\u6c42" - }, - "AppRequest": { - "properties": { - "package": { - "type": "string", - "title": "Package" - } - }, - "type": "object", - "required": [ - "package" - ], - "title": "AppRequest" - }, - "BatchAddFriendRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "user_ids": { - "items": { - "type": "string" - }, - "type": "array", - "title": "User Ids" - }, - "message": { - "type": "string", - "title": "Message", - "default": "" - }, - "interval": { - "type": "number", - "title": "Interval", - "default": 5.0 - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "user_ids" - ], - "title": "BatchAddFriendRequest", - "description": "\u6279\u91cf\u6dfb\u52a0\u597d\u53cb\u8bf7\u6c42" - }, - "BatchSendMessageRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "to_ids": { - "items": { - "type": "string" - }, - "type": "array", - "title": "To Ids" - }, - "content": { - "type": "string", - "title": "Content" - }, - "msg_type": { - "$ref": "#/components/schemas/MessageType", - "default": "text" - }, - "media_url": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "Media Url" - }, - "interval": { - "type": "number", - "title": "Interval", - "default": 2.0 - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "to_ids", - "content" - ], - "title": "BatchSendMessageRequest", - "description": "\u6279\u91cf\u53d1\u9001\u6d88\u606f\u8bf7\u6c42" - }, - "Body_upload_script_api_v3_scripts_post": { - "properties": { - "file": { - "type": "string", - "format": "binary", - "title": "File" - } - }, - "type": "object", - "required": [ - "file" - ], - "title": "Body_upload_script_api_v3_scripts_post" - }, - "ChangePasswordRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "old_pwd": { - "type": "string", - "title": "Old Pwd" - }, - "new_pwd": { - "type": "string", - "title": "New Pwd" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "old_pwd", - "new_pwd" - ], - "title": "ChangePasswordRequest" - }, - "ChatSettingRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "user_id": { - "type": "string", - "title": "User Id" - }, - "enable": { - "type": "boolean", - "title": "Enable", - "default": true - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "user_id" - ], - "title": "ChatSettingRequest" - }, - "ClickRequest": { - "properties": { - "x": { - "type": "integer", - "title": "X" - }, - "y": { - "type": "integer", - "title": "Y" - } - }, - "type": "object", - "required": [ - "x", - "y" - ], - "title": "ClickRequest", - "description": "\u70b9\u51fb\u8bf7\u6c42" - }, - "ClickTextRequest": { - "properties": { - "text": { - "type": "string", - "title": "Text" - }, - "timeout": { - "type": "integer", - "title": "Timeout", - "default": 10 - } - }, - "type": "object", - "required": [ - "text" - ], - "title": "ClickTextRequest", - "description": "\u70b9\u51fb\u6587\u5b57\u8bf7\u6c42" - }, - "CommentMomentsRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "user_id": { - "type": "string", - "title": "User Id" - }, - "post_index": { - "type": "integer", - "title": "Post Index", - "default": 0 - }, - "comment": { - "type": "string", - "title": "Comment" - }, - "reply_to": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "Reply To" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "user_id", - "comment" - ], - "title": "CommentMomentsRequest", - "description": "\u8bc4\u8bba\u670b\u53cb\u5708\u8bf7\u6c42" - }, - "CreateGroupRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "group_name": { - "type": "string", - "title": "Group Name" - }, - "member_ids": { - "items": { - "type": "string" - }, - "type": "array", - "title": "Member Ids" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "group_name", - "member_ids" - ], - "title": "CreateGroupRequest", - "description": "\u521b\u5efa\u7fa4\u804a\u8bf7\u6c42" - }, - "CreateTagRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "tag_name": { - "type": "string", - "title": "Tag Name" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "tag_name" - ], - "title": "CreateTagRequest", - "description": "\u521b\u5efa\u6807\u7b7e\u8bf7\u6c42" - }, - "DeleteFriendRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "user_id": { - "type": "string", - "title": "User Id" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "user_id" - ], - "title": "DeleteFriendRequest", - "description": "\u5220\u9664\u597d\u53cb\u8bf7\u6c42" - }, - "DeleteTagRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "tag_name": { - "type": "string", - "title": "Tag Name" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "tag_name" - ], - "title": "DeleteTagRequest", - "description": "\u5220\u9664\u6807\u7b7e\u8bf7\u6c42" - }, - "DeployScriptRequest": { - "properties": { - "device_ids": { - "items": { - "type": "string" - }, - "type": "array", - "title": "Device Ids" - }, - "auto_reload": { - "type": "boolean", - "title": "Auto Reload", - "default": true - } - }, - "type": "object", - "required": [ - "device_ids" - ], - "title": "DeployScriptRequest" - }, - "ExecuteCommand": { - "properties": { - "action": { - "type": "string", - "title": "Action" - }, - "params": { - "anyOf": [ - { - "additionalProperties": true, - "type": "object" - }, - { - "type": "null" - } - ], - "title": "Params", - "default": {} - } - }, - "type": "object", - "required": [ - "action" - ], - "title": "ExecuteCommand", - "description": "\u6267\u884c\u547d\u4ee4\u8bf7\u6c42" - }, - "ExecuteTaskRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "task": { - "type": "string", - "title": "Task" - }, - "llm_provider": { - "type": "string", - "title": "Llm Provider", - "default": "deepseek" - }, - "max_steps": { - "type": "integer", - "title": "Max Steps", - "default": 30 - } - }, - "type": "object", - "required": [ - "device_id", - "task" - ], - "title": "ExecuteTaskRequest", - "description": "\u6267\u884c\u4efb\u52a1\u8bf7\u6c42" - }, - "ForwardMessageRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "to_id": { - "type": "string", - "title": "To Id" - }, - "content": { - "type": "string", - "title": "Content" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "to_id", - "content" - ], - "title": "ForwardMessageRequest" - }, - "GetMessagesRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "conversation_id": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "Conversation Id" - }, - "limit": { - "type": "integer", - "title": "Limit", - "default": 20 - }, - "since_time": { - "anyOf": [ - { - "type": "integer" - }, - { - "type": "null" - } - ], - "title": "Since Time" - } - }, - "type": "object", - "required": [ - "device_id", - "platform" - ], - "title": "GetMessagesRequest", - "description": "\u83b7\u53d6\u6d88\u606f\u8bf7\u6c42" - }, - "GetMomentsRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "user_id": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "User Id" - }, - "limit": { - "type": "integer", - "title": "Limit", - "default": 10 - } - }, - "type": "object", - "required": [ - "device_id", - "platform" - ], - "title": "GetMomentsRequest", - "description": "\u83b7\u53d6\u670b\u53cb\u5708\u8bf7\u6c42" - }, - "GetUsersByTagRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "tag_name": { - "type": "string", - "title": "Tag Name" - }, - "limit": { - "type": "integer", - "title": "Limit", - "default": 100 - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "tag_name" - ], - "title": "GetUsersByTagRequest", - "description": "\u6839\u636e\u6807\u7b7e\u83b7\u53d6\u7528\u6237\u8bf7\u6c42" - }, - "GroupMessageRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "group_id": { - "type": "string", - "title": "Group Id" - }, - "content": { - "type": "string", - "title": "Content" - }, - "msg_type": { - "$ref": "#/components/schemas/MessageType", - "default": "text" - }, - "media_url": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "Media Url" - }, - "at_all": { - "type": "boolean", - "title": "At All", - "default": false - }, - "at_list": { - "anyOf": [ - { - "items": { - "type": "string" - }, - "type": "array" - }, - { - "type": "null" - } - ], - "title": "At List" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "group_id", - "content" - ], - "title": "GroupMessageRequest", - "description": "\u7fa4\u53d1\u6d88\u606f\u8bf7\u6c42" - }, - "HTTPValidationError": { - "properties": { - "detail": { - "items": { - "$ref": "#/components/schemas/ValidationError" - }, - "type": "array", - "title": "Detail" - } - }, - "type": "object", - "title": "HTTPValidationError" - }, - "HeartbeatConfigRequest": { - "properties": { - "heartbeat_interval_seconds": { - "type": "integer", - "title": "Heartbeat Interval Seconds" - } - }, - "type": "object", - "required": [ - "heartbeat_interval_seconds" - ], - "title": "HeartbeatConfigRequest", - "description": "\u5fc3\u8df3\u914d\u7f6e\u8bf7\u6c42" - }, - "InputRequest": { - "properties": { - "text": { - "type": "string", - "title": "Text" - }, - "clear": { - "type": "boolean", - "title": "Clear", - "default": true - } - }, - "type": "object", - "required": [ - "text" - ], - "title": "InputRequest" - }, - "InviteToGroupRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "group_id": { - "type": "string", - "title": "Group Id" - }, - "member_ids": { - "items": { - "type": "string" - }, - "type": "array", - "title": "Member Ids" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "group_id", - "member_ids" - ], - "title": "InviteToGroupRequest", - "description": "\u9080\u8bf7\u5165\u7fa4\u8bf7\u6c42" - }, - "KeyRequest": { - "properties": { - "key": { - "type": "string", - "title": "Key" - } - }, - "type": "object", - "required": [ - "key" - ], - "title": "KeyRequest" - }, - "LikeMomentsRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "user_id": { - "type": "string", - "title": "User Id" - }, - "post_index": { - "type": "integer", - "title": "Post Index", - "default": 0 - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "user_id" - ], - "title": "LikeMomentsRequest", - "description": "\u70b9\u8d5e\u670b\u53cb\u5708\u8bf7\u6c42" - }, - "MassSendRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "content": { - "type": "string", - "title": "Content" - }, - "user_ids": { - "items": { - "type": "string" - }, - "type": "array", - "title": "User Ids" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "content", - "user_ids" - ], - "title": "MassSendRequest" - }, - "MessageType": { - "type": "string", - "enum": [ - "text", - "image", - "video", - "voice", - "file", - "link", - "mini_program" - ], - "title": "MessageType", - "description": "\u6d88\u606f\u7c7b\u578b" - }, - "ModuleUpsertRequest": { - "properties": { - "module_id": { - "type": "string", - "title": "Module Id" - }, - "name": { - "type": "string", - "title": "Name" - }, - "version": { - "type": "string", - "title": "Version", - "default": "1.0.0" - }, - "description": { - "type": "string", - "title": "Description", - "default": "" - }, - "scopes": { - "items": { - "type": "string" - }, - "type": "array", - "title": "Scopes" - }, - "capabilities": { - "items": { - "type": "string" - }, - "type": "array", - "title": "Capabilities" - }, - "min_frida_version": { - "type": "string", - "title": "Min Frida Version", - "default": "16.0.0" - }, - "script_content": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "Script Content" - }, - "enabled": { - "type": "boolean", - "title": "Enabled", - "default": true - } - }, - "type": "object", - "required": [ - "module_id", - "name" - ], - "title": "ModuleUpsertRequest" - }, - "Platform": { - "type": "string", - "enum": [ - "wechat", - "douyin", - "xhs", - "xianyu", - "soul" - ], - "title": "Platform", - "description": "\u652f\u6301\u7684\u5e73\u53f0" - }, - "PostMomentsRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "content": { - "type": "string", - "title": "Content" - }, - "images": { - "anyOf": [ - { - "items": { - "type": "string" - }, - "type": "array" - }, - { - "type": "null" - } - ], - "title": "Images" - }, - "video_url": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "Video Url" - }, - "location": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "Location" - }, - "visible_list": { - "anyOf": [ - { - "items": { - "type": "string" - }, - "type": "array" - }, - { - "type": "null" - } - ], - "title": "Visible List" - }, - "invisible_list": { - "anyOf": [ - { - "items": { - "type": "string" - }, - "type": "array" - }, - { - "type": "null" - } - ], - "title": "Invisible List" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "content" - ], - "title": "PostMomentsRequest", - "description": "\u53d1\u5e03\u670b\u53cb\u5708\u8bf7\u6c42" - }, - "ProjectBindConfig": { - "properties": { - "project_id": { - "type": "string", - "title": "Project Id" - }, - "project_name": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "Project Name", - "default": "" - }, - "server": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "Server", - "default": "ws://sdk.quwanzhi.com:8899/ws/device" - } - }, - "type": "object", - "required": [ - "project_id" - ], - "title": "ProjectBindConfig", - "description": "\u9879\u76ee\u7ed1\u5b9a\u914d\u7f6e" - }, - "RecordOperation": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "app": { - "type": "string", - "title": "App" - }, - "action": { - "type": "string", - "title": "Action" - }, - "params": { - "additionalProperties": true, - "type": "object", - "title": "Params" - }, - "result": { - "additionalProperties": true, - "type": "object", - "title": "Result" - }, - "duration_ms": { - "type": "integer", - "title": "Duration Ms" - } - }, - "type": "object", - "required": [ - "device_id", - "app", - "action", - "params", - "result", - "duration_ms" - ], - "title": "RecordOperation" - }, - "RedPacketRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "to_id": { - "type": "string", - "title": "To Id" - }, - "amount": { - "type": "string", - "title": "Amount" - }, - "message": { - "type": "string", - "title": "Message", - "default": "\u606d\u559c\u53d1\u8d22" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "to_id", - "amount" - ], - "title": "RedPacketRequest" - }, - "ReloadDeviceModulesRequest": { - "properties": { - "module_ids": { - "items": { - "type": "string" - }, - "type": "array", - "title": "Module Ids" - }, - "force": { - "type": "boolean", - "title": "Force", - "default": false - } - }, - "type": "object", - "required": [ - "module_ids" - ], - "title": "ReloadDeviceModulesRequest" - }, - "RemoveFromGroupRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "group_id": { - "type": "string", - "title": "Group Id" - }, - "member_ids": { - "items": { - "type": "string" - }, - "type": "array", - "title": "Member Ids" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "group_id", - "member_ids" - ], - "title": "RemoveFromGroupRequest", - "description": "\u79fb\u51fa\u7fa4\u804a\u8bf7\u6c42" - }, - "RemoveTagRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "user_id": { - "type": "string", - "title": "User Id" - }, - "tags": { - "items": { - "type": "string" - }, - "type": "array", - "title": "Tags" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "user_id", - "tags" - ], - "title": "RemoveTagRequest", - "description": "\u79fb\u9664\u6807\u7b7e\u8bf7\u6c42" - }, - "ReplyCommentRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "video_id": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "Video Id" - }, - "comment_id": { - "type": "string", - "title": "Comment Id" - }, - "content": { - "type": "string", - "title": "Content" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "comment_id", - "content" - ], - "title": "ReplyCommentRequest", - "description": "\u56de\u590d\u8bc4\u8bba\u8bf7\u6c42\uff08\u6296\u97f3/\u5c0f\u7ea2\u4e66\u7b49\uff09" - }, - "ScopeUpdateRequest": { - "properties": { - "scopes": { - "items": { - "type": "string" - }, - "type": "array", - "title": "Scopes" - } - }, - "type": "object", - "required": [ - "scopes" - ], - "title": "ScopeUpdateRequest" - }, - "SendCardRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "to_id": { - "type": "string", - "title": "To Id" - }, - "card_wxid": { - "type": "string", - "title": "Card Wxid" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "to_id", - "card_wxid" - ], - "title": "SendCardRequest" - }, - "SendMessageRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "to_id": { - "type": "string", - "title": "To Id" - }, - "content": { - "type": "string", - "title": "Content" - }, - "msg_type": { - "$ref": "#/components/schemas/MessageType", - "default": "text" - }, - "media_url": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "Media Url" - }, - "at_list": { - "anyOf": [ - { - "items": { - "type": "string" - }, - "type": "array" - }, - { - "type": "null" - } - ], - "title": "At List" - }, - "timeout_seconds": { - "anyOf": [ - { - "type": "integer" - }, - { - "type": "null" - } - ], - "title": "Timeout Seconds" - }, - "channel": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "Channel" - }, - "hook_config": { - "anyOf": [ - { - "additionalProperties": true, - "type": "object" - }, - { - "type": "null" - } - ], - "title": "Hook Config" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "to_id", - "content" - ], - "title": "SendMessageRequest", - "description": "\u53d1\u9001\u6d88\u606f\u8bf7\u6c42" - }, - "SetAvatarRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "image_path": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "Image Path" - } - }, - "type": "object", - "required": [ - "device_id", - "platform" - ], - "title": "SetAvatarRequest" - }, - "SetGenderRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "gender": { - "type": "string", - "title": "Gender" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "gender" - ], - "title": "SetGenderRequest" - }, - "SetGroupNameRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "group_id": { - "type": "string", - "title": "Group Id" - }, - "group_name": { - "type": "string", - "title": "Group Name" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "group_id", - "group_name" - ], - "title": "SetGroupNameRequest", - "description": "\u8bbe\u7f6e\u7fa4\u540d\u8bf7\u6c42" - }, - "SetGroupNoticeRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "group_id": { - "type": "string", - "title": "Group Id" - }, - "notice": { - "type": "string", - "title": "Notice" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "group_id", - "notice" - ], - "title": "SetGroupNoticeRequest", - "description": "\u8bbe\u7f6e\u7fa4\u516c\u544a\u8bf7\u6c42" - }, - "SetGroupWelcomeRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "group_id": { - "type": "string", - "title": "Group Id" - }, - "welcome_text": { - "type": "string", - "title": "Welcome Text" - }, - "welcome_image": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "Welcome Image" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "group_id", - "welcome_text" - ], - "title": "SetGroupWelcomeRequest", - "description": "\u8bbe\u7f6e\u7fa4\u6b22\u8fce\u8bed\u8bf7\u6c42" - }, - "SetNicknameRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "nickname": { - "type": "string", - "title": "Nickname" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "nickname" - ], - "title": "SetNicknameRequest" - }, - "SetRegionRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "region": { - "type": "string", - "title": "Region" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "region" - ], - "title": "SetRegionRequest" - }, - "SetRemarkRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "user_id": { - "type": "string", - "title": "User Id" - }, - "remark": { - "type": "string", - "title": "Remark" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "user_id", - "remark" - ], - "title": "SetRemarkRequest", - "description": "\u8bbe\u7f6e\u5907\u6ce8\u8bf7\u6c42" - }, - "SetSignatureRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "signature": { - "type": "string", - "title": "Signature" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "signature" - ], - "title": "SetSignatureRequest" - }, - "ShortcutCreate": { - "properties": { - "name": { - "type": "string", - "title": "Name" - }, - "description": { - "type": "string", - "title": "Description" - }, - "steps": { - "items": { - "additionalProperties": true, - "type": "object" - }, - "type": "array", - "title": "Steps" - } - }, - "type": "object", - "required": [ - "name", - "description", - "steps" - ], - "title": "ShortcutCreate" - }, - "ShortcutExecute": { - "properties": { - "variables": { - "anyOf": [ - { - "additionalProperties": { - "type": "string" - }, - "type": "object" - }, - { - "type": "null" - } - ], - "title": "Variables" - } - }, - "type": "object", - "title": "ShortcutExecute" - }, - "SimHeartbeatRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - } - }, - "type": "object", - "required": [ - "device_id" - ], - "title": "SimHeartbeatRequest" - }, - "SimHookEventRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "type": "string", - "title": "Platform", - "default": "wechat" - }, - "event_type": { - "type": "string", - "title": "Event Type", - "default": "message_received" - }, - "payload": { - "additionalProperties": true, - "type": "object", - "title": "Payload" - } - }, - "type": "object", - "required": [ - "device_id" - ], - "title": "SimHookEventRequest" - }, - "SimRegisterRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "project_id": { - "type": "string", - "title": "Project Id", - "default": "cunkebao" - }, - "model": { - "type": "string", - "title": "Model", - "default": "Simulator Device" - }, - "platform": { - "type": "string", - "title": "Platform", - "default": "android" - }, - "capabilities": { - "items": { - "type": "string" - }, - "type": "array", - "title": "Capabilities" - } - }, - "type": "object", - "required": [ - "device_id" - ], - "title": "SimRegisterRequest" - }, - "StartCaptureRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - } - }, - "type": "object", - "required": [ - "device_id" - ], - "title": "StartCaptureRequest" - }, - "StopCaptureRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - } - }, - "type": "object", - "required": [ - "device_id" - ], - "title": "StopCaptureRequest" - }, - "SwipeRequest": { - "properties": { - "direction": { - "type": "string", - "title": "Direction" - }, - "scale": { - "type": "number", - "title": "Scale", - "default": 0.5 - } - }, - "type": "object", - "required": [ - "direction" - ], - "title": "SwipeRequest" - }, - "TransferRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "to_id": { - "type": "string", - "title": "To Id" - }, - "amount": { - "type": "string", - "title": "Amount" - }, - "message": { - "type": "string", - "title": "Message", - "default": "" - } - }, - "type": "object", - "required": [ - "device_id", - "platform", - "to_id", - "amount" - ], - "title": "TransferRequest" - }, - "UnblockAccountRequest": { - "properties": { - "device_id": { - "type": "string", - "title": "Device Id" - }, - "platform": { - "$ref": "#/components/schemas/Platform" - }, - "helper_wxid": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "Helper Wxid" - } - }, - "type": "object", - "required": [ - "device_id", - "platform" - ], - "title": "UnblockAccountRequest" - }, - "ValidationError": { - "properties": { - "loc": { - "items": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "integer" - } - ] - }, - "type": "array", - "title": "Location" - }, - "msg": { - "type": "string", - "title": "Message" - }, - "type": { - "type": "string", - "title": "Error Type" - } - }, - "type": "object", - "required": [ - "loc", - "msg", - "type" - ], - "title": "ValidationError" - }, - "VoiceCommandRequest": { - "properties": { - "text": { - "type": "string", - "title": "Text" - }, - "device_id": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "Device Id" - }, - "project_id": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ], - "title": "Project Id" - }, - "execute": { - "type": "boolean", - "title": "Execute", - "default": true - } - }, - "type": "object", - "required": [ - "text" - ], - "title": "VoiceCommandRequest", - "description": "\u8bed\u97f3\u547d\u4ee4\u8bf7\u6c42" - }, - "VoiceCommandResponse": { - "properties": { - "success": { - "type": "boolean", - "title": "Success" - }, - "message": { - "type": "string", - "title": "Message" - }, - "text": { - "type": "string", - "title": "Text" - }, - "actions": { - "items": { - "additionalProperties": true, - "type": "object" - }, - "type": "array", - "title": "Actions" - }, - "executed": { - "type": "boolean", - "title": "Executed", - "default": false - } - }, - "type": "object", - "required": [ - "success", - "message", - "text", - "actions" - ], - "title": "VoiceCommandResponse", - "description": "\u8bed\u97f3\u547d\u4ee4\u54cd\u5e94" - }, - "routers__adb__ClickRequest": { - "properties": { - "x": { - "type": "integer", - "title": "X" - }, - "y": { - "type": "integer", - "title": "Y" - } - }, - "type": "object", - "required": [ - "x", - "y" - ], - "title": "ClickRequest" - }, - "routers__adb__ClickTextRequest": { - "properties": { - "text": { - "type": "string", - "title": "Text" - }, - "timeout": { - "type": "number", - "title": "Timeout", - "default": 10 - } - }, - "type": "object", - "required": [ - "text" - ], - "title": "ClickTextRequest" - }, - "routers__devices__InputRequest": { - "properties": { - "text": { - "type": "string", - "title": "Text" - }, - "clear": { - "type": "boolean", - "title": "Clear", - "default": true - } - }, - "type": "object", - "required": [ - "text" - ], - "title": "InputRequest", - "description": "\u8f93\u5165\u8bf7\u6c42" - }, - "routers__devices__SwipeRequest": { - "properties": { - "direction": { - "type": "string", - "title": "Direction" - }, - "scale": { - "type": "number", - "title": "Scale", - "default": 0.8 - } - }, - "type": "object", - "required": [ - "direction" - ], - "title": "SwipeRequest", - "description": "\u6ed1\u52a8\u8bf7\u6c42" + "/api/v3/devices/{device_id}": { + "get": { + "tags": [ + "设备管理" + ], + "summary": "Get Device", + "description": "获取设备详情(支持 WebSocket / ADB / DB)", + "operationId": "get_device_api_v3_devices__device_id__get", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Device Api V3 Devices Device Id Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } } + } }, - "tags": [ - { - "name": "\u6d88\u606f\u7ba1\u7406", - "description": "\u53d1\u9001/\u83b7\u53d6/\u8f6c\u53d1/\u64a4\u56de/\u540d\u7247/\u8bed\u97f3\u6d88\u606f \u2014 8\u4e2a\u7aef\u70b9" - }, - { - "name": "\u597d\u53cb\u7ba1\u7406", - "description": "\u6dfb\u52a0/\u901a\u8fc7/\u5907\u6ce8/\u5220\u9664/\u641c\u7d22/\u6279\u91cf \u2014 8\u4e2a\u7aef\u70b9" - }, - { - "name": "\u7fa4\u804a\u7ba1\u7406", - "description": "\u521b\u5efa/\u9080\u8bf7/\u79fb\u9664/\u516c\u544a/\u7fa4\u540d/\u7fa4\u6d88\u606f/\u6b22\u8fce\u8bed/\u9000\u7fa4 \u2014 10\u4e2a\u7aef\u70b9" - }, - { - "name": "\u6807\u7b7e\u7ba1\u7406", - "description": "\u521b\u5efa/\u5220\u9664/\u6253\u6807/\u53d6\u6807/\u67e5\u4eba \u2014 6\u4e2a\u7aef\u70b9" - }, - { - "name": "\u670b\u53cb\u5708\u7ba1\u7406", - "description": "\u53d1\u5e03/\u70b9\u8d5e/\u8bc4\u8bba/\u5220\u9664/\u5c01\u9762/\u53ef\u89c1\u5929\u6570/\u5206\u4eab\u94fe\u63a5 \u2014 8\u4e2a\u7aef\u70b9" - }, - { - "name": "\u4e2a\u4eba\u8bbe\u7f6e", - "description": "\u83b7\u53d6\u8d44\u6599/\u6635\u79f0/\u7b7e\u540d/\u5934\u50cf/\u6027\u522b/\u5730\u533a \u2014 6\u4e2a\u7aef\u70b9" - }, - { - "name": "\u8d26\u53f7\u5b89\u5168", - "description": "\u72b6\u6001/\u89e3\u5c01/\u5b89\u5168\u4e2d\u5fc3/\u6539\u5bc6\u7801/\u7533\u8bc9/\u9650\u5236\u68c0\u67e5 \u2014 9\u4e2a\u7aef\u70b9" - }, - { - "name": "\u6536\u85cf\u7ba1\u7406", - "description": "\u6536\u85cf/\u6536\u85cf\u5217\u8868 \u2014 2\u4e2a\u7aef\u70b9" - }, - { - "name": "\u652f\u4ed8", - "description": "\u7ea2\u5305/\u8f6c\u8d26/\u4ed8\u6b3e\u7801/\u6536\u6b3e/\u94b1\u5305/\u8d26\u5355/\u9886\u7ea2\u5305 \u2014 7\u4e2a\u7aef\u70b9" - }, - { - "name": "\u804a\u5929\u8bbe\u7f6e", - "description": "\u7f6e\u9876/\u514d\u6253\u6270/\u6e05\u7a7a\u8bb0\u5f55 \u2014 3\u4e2a\u7aef\u70b9" - }, - { - "name": "\u5c0f\u7a0b\u5e8f", - "description": "\u6253\u5f00\u5c0f\u7a0b\u5e8f \u2014 1\u4e2a\u7aef\u70b9" - }, - { - "name": "\u516c\u4f17\u53f7", - "description": "\u5173\u6ce8\u516c\u4f17\u53f7 \u2014 1\u4e2a\u7aef\u70b9" - }, - { - "name": "\u89c6\u9891\u53f7", - "description": "\u5217\u8868/\u70b9\u8d5e/\u8bc4\u8bba/\u5173\u6ce8/\u5206\u4eab \u2014 5\u4e2a\u7aef\u70b9" - }, - { - "name": "\u626b\u4e00\u626b", - "description": "\u626b\u7801/\u52a0\u597d\u53cb/\u6211\u7684\u4e8c\u7ef4\u7801/\u56fe\u7247\u8bc6\u522b \u2014 4\u4e2a\u7aef\u70b9" - }, - { - "name": "\u901a\u8bdd", - "description": "\u8bed\u97f3\u901a\u8bdd/\u89c6\u9891\u901a\u8bdd \u2014 2\u4e2a\u7aef\u70b9" - }, - { - "name": "\u7fa4\u53d1\u52a9\u624b", - "description": "\u7fa4\u53d1\u6d88\u606f \u2014 1\u4e2a\u7aef\u70b9" - }, - { - "name": "\u641c\u4e00\u641c", - "description": "\u5fae\u4fe1\u641c\u4e00\u641c \u2014 1\u4e2a\u7aef\u70b9" - }, - { - "name": "\u770b\u4e00\u770b", - "description": "\u5fae\u4fe1\u770b\u4e00\u770b \u2014 1\u4e2a\u7aef\u70b9" - }, - { - "name": "\u5fae\u4fe1\u8fd0\u52a8", - "description": "\u6b65\u6570/\u70b9\u8d5e \u2014 2\u4e2a\u7aef\u70b9" - }, - { - "name": "\u4f4d\u7f6e", - "description": "\u53d1\u9001\u4f4d\u7f6e/\u5171\u4eab\u5b9e\u65f6\u4f4d\u7f6e \u2014 2\u4e2a\u7aef\u70b9" - }, - { - "name": "\u8868\u60c5", - "description": "\u53d1\u9001\u8868\u60c5/\u8868\u60c5\u5305\u5217\u8868 \u2014 2\u4e2a\u7aef\u70b9" - }, - { - "name": "\u6587\u4ef6\u7ba1\u7406", - "description": "\u53d1\u9001\u6587\u4ef6/\u4e0b\u8f7d\u6587\u4ef6 \u2014 2\u4e2a\u7aef\u70b9" - }, - { - "name": "\u8bbe\u7f6e", - "description": "\u52ff\u6270/\u6e05\u7f13\u5b58/\u68c0\u67e5\u66f4\u65b0/\u9000\u51fa/\u5207\u6362\u8d26\u53f7 \u2014 5\u4e2a\u7aef\u70b9" - }, - { - "name": "\u8bbe\u5907\u7ba1\u7406", - "description": "\u8bbe\u5907\u5217\u8868/\u72b6\u6001/\u622a\u56fe/ADB\u63a7\u5236" - }, - { - "name": "AI Agent", - "description": "\u81ea\u7136\u8bed\u8a00\u63a7\u5236\u624b\u673a" - }, - { - "name": "\u9632\u5c01\u76d1\u63a7", - "description": "\u64cd\u4f5c\u9891\u7387/\u5185\u5bb9/\u8d26\u53f7\u751f\u547d\u5468\u671f \u2014 2\u4e2a\u7aef\u70b9" + "/api/v3/devices/{device_id}/heartbeat": { + "get": { + "tags": [ + "设备管理" + ], + "summary": "Get Device Heartbeat", + "description": "查询设备心跳状态", + "operationId": "get_device_heartbeat_api_v3_devices__device_id__heartbeat_get", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Device Heartbeat Api V3 Devices Device Id Heartbeat Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } } - ] -} + } + }, + "/api/v3/devices/{device_id}/heartbeat/config": { + "post": { + "tags": [ + "设备管理" + ], + "summary": "Set Device Heartbeat", + "description": "下发设备心跳配置(5-120 秒)", + "operationId": "set_device_heartbeat_api_v3_devices__device_id__heartbeat_config_post", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HeartbeatConfigRequest" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Set Device Heartbeat Api V3 Devices Device Id Heartbeat Config Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/devices/{device_id}/screenshot": { + "post": { + "tags": [ + "设备管理" + ], + "summary": "Screenshot", + "description": "获取设备截图", + "operationId": "screenshot_api_v3_devices__device_id__screenshot_post", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Screenshot Api V3 Devices Device Id Screenshot Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/devices/{device_id}/click": { + "post": { + "tags": [ + "设备管理" + ], + "summary": "Click", + "description": "点击坐标", + "operationId": "click_api_v3_devices__device_id__click_post", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/routers__devices__ClickRequest" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Click Api V3 Devices Device Id Click Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/devices/{device_id}/click-text": { + "post": { + "tags": [ + "设备管理" + ], + "summary": "Click Text", + "description": "点击文字", + "operationId": "click_text_api_v3_devices__device_id__click_text_post", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ClickTextRequest" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Click Text Api V3 Devices Device Id Click Text Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/devices/{device_id}/input": { + "post": { + "tags": [ + "设备管理" + ], + "summary": "Input Text", + "description": "输入文字", + "operationId": "input_text_api_v3_devices__device_id__input_post", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/InputRequest" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Input Text Api V3 Devices Device Id Input Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/devices/{device_id}/swipe": { + "post": { + "tags": [ + "设备管理" + ], + "summary": "Swipe", + "description": "滑动", + "operationId": "swipe_api_v3_devices__device_id__swipe_post", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/routers__devices__SwipeRequest" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Swipe Api V3 Devices Device Id Swipe Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/devices/{device_id}/ui-tree": { + "get": { + "tags": [ + "设备管理" + ], + "summary": "Get Ui Tree", + "description": "获取UI树", + "operationId": "get_ui_tree_api_v3_devices__device_id__ui_tree_get", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Ui Tree Api V3 Devices Device Id Ui Tree Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/devices/{device_id}/execute": { + "post": { + "tags": [ + "设备管理" + ], + "summary": "Execute Script", + "description": "执行脚本", + "operationId": "execute_script_api_v3_devices__device_id__execute_post", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "script", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Script" + } + }, + { + "name": "action", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Action" + } + }, + { + "name": "timeout", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 30, + "title": "Timeout" + } + } + ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "default": {}, + "title": "Params" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Execute Script Api V3 Devices Device Id Execute Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/devices/{device_id}/ai/status": { + "get": { + "tags": [ + "设备管理" + ], + "summary": "Get Ai Brain Status", + "description": "获取设备 AI Brain 状态", + "operationId": "get_ai_brain_status_api_v3_devices__device_id__ai_status_get", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Ai Brain Status Api V3 Devices Device Id Ai Status Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/devices/{device_id}/ai/task": { + "post": { + "tags": [ + "设备管理" + ], + "summary": "Push Ai Task", + "description": "向设备推送 AI 任务(AI Brain 会在下次心跳周期执行)", + "operationId": "push_ai_task_api_v3_devices__device_id__ai_task_post", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/AITaskRequest" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Push Ai Task Api V3 Devices Device Id Ai Task Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/devices/{device_id}/ai/standing-order": { + "post": { + "tags": [ + "设备管理" + ], + "summary": "Push Standing Order", + "description": "向设备推送常驻指令(离线时自动执行)", + "operationId": "push_standing_order_api_v3_devices__device_id__ai_standing_order_post", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/StandingOrderRequest" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Push Standing Order Api V3 Devices Device Id Ai Standing Order Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/devices/{device_id}/ai/execute": { + "post": { + "tags": [ + "设备管理" + ], + "summary": "Ai Execute", + "description": "让设备 AI Agent 执行自然语言任务(同步等待结果)", + "operationId": "ai_execute_api_v3_devices__device_id__ai_execute_post", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "task", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Task" + } + }, + { + "name": "timeout", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 60, + "title": "Timeout" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Ai Execute Api V3 Devices Device Id Ai Execute Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/heartbeat/dashboard": { + "get": { + "tags": [ + "设备管理" + ], + "summary": "Heartbeat Dashboard", + "description": "AI 心跳监控仪表盘 — 所有设备健康总览", + "operationId": "heartbeat_dashboard_api_v3_heartbeat_dashboard_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Heartbeat Dashboard Api V3 Heartbeat Dashboard Get" + } + } + } + } + } + } + }, + "/api/v3/devices/{device_id}/health": { + "get": { + "tags": [ + "设备管理" + ], + "summary": "Device Health", + "description": "获取单台设备的 AI 健康评分与状态", + "operationId": "device_health_api_v3_devices__device_id__health_get", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Device Health Api V3 Devices Device Id Health Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/devices/{device_id}/health/events": { + "get": { + "tags": [ + "设备管理" + ], + "summary": "Device Health Events", + "description": "获取设备健康事件(告警历史)", + "operationId": "device_health_events_api_v3_devices__device_id__health_events_get", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 30, + "title": "Limit" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Device Health Events Api V3 Devices Device Id Health Events Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/heartbeat/events": { + "get": { + "tags": [ + "设备管理" + ], + "summary": "All Health Events", + "description": "全局健康事件流", + "operationId": "all_health_events_api_v3_heartbeat_events_get", + "parameters": [ + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 50, + "title": "Limit" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response All Health Events Api V3 Heartbeat Events Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/devices/{device_id}/ai/queue-task": { + "post": { + "tags": [ + "设备管理" + ], + "summary": "Queue Ai Task", + "description": "向设备心跳任务队列添加待执行任务(心跳周期自动下发)", + "operationId": "queue_ai_task_api_v3_devices__device_id__ai_queue_task_post", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/AITaskRequest" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Queue Ai Task Api V3 Devices Device Id Ai Queue Task Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/devices/{device_id}/guard-events": { + "get": { + "tags": [ + "设备管理", + "连接守护" + ], + "summary": "Get Guard Events", + "description": "获取设备的连接守护事件(弹窗处理、异常告警等)", + "operationId": "get_guard_events_api_v3_devices__device_id__guard_events_get", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 50, + "title": "Limit" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Guard Events Api V3 Devices Device Id Guard Events Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + }, + "post": { + "tags": [ + "设备管理", + "连接守护" + ], + "summary": "Post Guard Event", + "description": "上报连接守护事件(Agent 心跳或守护循环调用)", + "operationId": "post_guard_event_api_v3_devices__device_id__guard_events_post", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Event" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Post Guard Event Api V3 Devices Device Id Guard Events Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/guard-events/all": { + "get": { + "tags": [ + "设备管理", + "连接守护" + ], + "summary": "Get All Guard Events", + "description": "获取所有设备的守护事件(全局视图)", + "operationId": "get_all_guard_events_api_v3_guard_events_all_get", + "parameters": [ + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 100, + "title": "Limit" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get All Guard Events Api V3 Guard Events All Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/hook/actions": { + "get": { + "tags": [ + "统一接口", + "Hook模块管理" + ], + "summary": "Hook Actions", + "description": "获取 Hook 支持的全部操作清单 — 107 个操作 / 24 个模块", + "operationId": "hook_actions_api_v3_hook_actions_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Hook Actions Api V3 Hook Actions Get" + } + } + } + } + } + } + }, + "/api/v3/hook/probe/{device_id}": { + "get": { + "tags": [ + "统一接口", + "Hook模块管理" + ], + "summary": "Hook Probe", + "description": "探测设备 Frida Hook 能力 — 连接 → ping → 版本 → 更新 device_modules\n\n用于首次入机或定期巡检,自动将 Hook 状态写入 device_modules.json。", + "operationId": "hook_probe_api_v3_hook_probe__device_id__get", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Hook Probe Api V3 Hook Probe Device Id Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/hook/data/{device_id}": { + "get": { + "tags": [ + "统一接口", + "Hook模块管理" + ], + "summary": "Hook Data", + "description": "一次性获取设备的 Hook 数据(联系人/消息/群/标签/资料等)\n\nmodules 参数用逗号分隔,可选值:\nprofile, contacts, groups, messages, labels, moments, accounts, hook_status, device_info", + "operationId": "hook_data_api_v3_hook_data__device_id__get", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "modules", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "profile,contacts,groups,messages,labels", + "title": "Modules" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Hook Data Api V3 Hook Data Device Id Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/hook/execute": { + "post": { + "tags": [ + "统一接口", + "Hook模块管理" + ], + "summary": "Hook Execute", + "description": "Hawk Hook 统一执行 — 单接口控制整台手机\n\n任意应用只需调此端点,传 action + params 即可执行 107 种操作。\n通道优先级:Frida Hook → WebSocket Agent → ADB UI自动化。\n\n示例:\n```json\n{\"device_id\":\"dc9c23e00510\",\"platform\":\"wechat\",\"action\":\"send_message\",\"params\":{\"to_id\":\"阿猫\",\"content\":\"你好\"}}\n{\"device_id\":\"dc9c23e00510\",\"platform\":\"wechat\",\"action\":\"get_profile\",\"params\":{},\"hook_only\":true}\n{\"device_id\":\"dc9c23e00510\",\"platform\":\"wechat\",\"action\":\"register_account\",\"params\":{\"phone\":\"13800138000\",\"nickname\":\"卡若AI\"}}\n```\n`hook_only:true` 时仅 Frida RPC,失败不降级 u2(需 Agent 已连上且 Frida 附着微信)。", + "operationId": "hook_execute_api_v3_hook_execute_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HookExecuteRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Hook Execute Api V3 Hook Execute Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/message/send": { + "post": { + "tags": [ + "统一接口", + "消息管理" + ], + "summary": "Send Message", + "description": "发送消息(统一接口)\n\n自动选择最优通道:\n1. 有官方API → 用API\n2. 设备在线 → 用SDK控制\n3. 兜底 → 用AI Agent\n\n超时:使用 MESSAGE_SEND_TIMEOUT(默认60s),超时返回 200 + success=false + error=timeout", + "operationId": "send_message_api_v3_message_send_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/SendMessageRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Send Message Api V3 Message Send Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/message/list": { + "post": { + "tags": [ + "统一接口", + "消息管理" + ], + "summary": "Get Messages", + "description": "获取消息列表", + "operationId": "get_messages_api_v3_message_list_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/GetMessagesRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Get Messages Api V3 Message List Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/message/batch-send": { + "post": { + "tags": [ + "统一接口", + "消息管理" + ], + "summary": "Batch Send Message", + "description": "批量发送消息(服务端逐条下发,间隔防风控,单条超时可控)", + "operationId": "batch_send_message_api_v3_message_batch_send_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/BatchSendMessageRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Batch Send Message Api V3 Message Batch Send Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/comment/reply": { + "post": { + "tags": [ + "统一接口", + "消息管理" + ], + "summary": "Reply Comment", + "description": "回复评论(抖音/小红书等)", + "operationId": "reply_comment_api_v3_comment_reply_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ReplyCommentRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Reply Comment Api V3 Comment Reply Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/friend/add": { + "post": { + "tags": [ + "统一接口", + "好友管理" + ], + "summary": "Add Friend", + "description": "添加好友", + "operationId": "add_friend_api_v3_friend_add_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/AddFriendRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Add Friend Api V3 Friend Add Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/friend/accept": { + "post": { + "tags": [ + "统一接口", + "好友管理" + ], + "summary": "Accept Friend", + "description": "通过好友请求", + "operationId": "accept_friend_api_v3_friend_accept_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/AcceptFriendRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Accept Friend Api V3 Friend Accept Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/friend/set-remark": { + "post": { + "tags": [ + "统一接口", + "好友管理" + ], + "summary": "Set Friend Remark", + "description": "设置好友备注", + "operationId": "set_friend_remark_api_v3_friend_set_remark_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/SetRemarkRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Set Friend Remark Api V3 Friend Set Remark Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/friend/delete": { + "post": { + "tags": [ + "统一接口", + "好友管理" + ], + "summary": "Delete Friend", + "description": "删除好友", + "operationId": "delete_friend_api_v3_friend_delete_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/DeleteFriendRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Delete Friend Api V3 Friend Delete Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/friend/batch-add": { + "post": { + "tags": [ + "统一接口", + "好友管理" + ], + "summary": "Batch Add Friend", + "description": "批量添加好友", + "operationId": "batch_add_friend_api_v3_friend_batch_add_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/BatchAddFriendRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Batch Add Friend Api V3 Friend Batch Add Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/contacts": { + "get": { + "tags": [ + "统一接口", + "好友管理" + ], + "summary": "Get Contacts", + "description": "获取联系人列表", + "operationId": "get_contacts_api_v3_contacts_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 100, + "title": "Limit" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Contacts Api V3 Contacts Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/group/create": { + "post": { + "tags": [ + "统一接口", + "群聊管理" + ], + "summary": "Create Group", + "description": "创建群聊", + "operationId": "create_group_api_v3_group_create_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/CreateGroupRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Create Group Api V3 Group Create Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/group/invite": { + "post": { + "tags": [ + "统一接口", + "群聊管理" + ], + "summary": "Invite To Group", + "description": "邀请入群", + "operationId": "invite_to_group_api_v3_group_invite_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/InviteToGroupRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Invite To Group Api V3 Group Invite Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/group/remove": { + "post": { + "tags": [ + "统一接口", + "群聊管理" + ], + "summary": "Remove From Group", + "description": "移出群聊", + "operationId": "remove_from_group_api_v3_group_remove_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/RemoveFromGroupRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Remove From Group Api V3 Group Remove Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/group/set-notice": { + "post": { + "tags": [ + "统一接口", + "群聊管理" + ], + "summary": "Set Group Notice", + "description": "设置群公告", + "operationId": "set_group_notice_api_v3_group_set_notice_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/SetGroupNoticeRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Set Group Notice Api V3 Group Set Notice Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/group/set-name": { + "post": { + "tags": [ + "统一接口", + "群聊管理" + ], + "summary": "Set Group Name", + "description": "设置群名", + "operationId": "set_group_name_api_v3_group_set_name_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/SetGroupNameRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Set Group Name Api V3 Group Set Name Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/group/send-message": { + "post": { + "tags": [ + "统一接口", + "群聊管理" + ], + "summary": "Send Group Message", + "description": "发送群消息", + "operationId": "send_group_message_api_v3_group_send_message_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/GroupMessageRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Send Group Message Api V3 Group Send Message Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/group/set-welcome": { + "post": { + "tags": [ + "统一接口", + "群聊管理" + ], + "summary": "Set Group Welcome", + "description": "设置群欢迎语", + "operationId": "set_group_welcome_api_v3_group_set_welcome_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/SetGroupWelcomeRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Set Group Welcome Api V3 Group Set Welcome Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/group/list": { + "get": { + "tags": [ + "统一接口", + "群聊管理" + ], + "summary": "Get Group List", + "description": "获取群聊列表", + "operationId": "get_group_list_api_v3_group_list_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 100, + "title": "Limit" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Group List Api V3 Group List Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/group/members": { + "get": { + "tags": [ + "统一接口", + "群聊管理" + ], + "summary": "Get Group Members", + "description": "获取群成员列表", + "operationId": "get_group_members_api_v3_group_members_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "group_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Group Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Group Members Api V3 Group Members Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/tag/add": { + "post": { + "tags": [ + "统一接口", + "标签管理" + ], + "summary": "Add Tag", + "description": "给好友添加标签", + "operationId": "add_tag_api_v3_tag_add_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/AddTagRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Add Tag Api V3 Tag Add Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/tag/remove": { + "post": { + "tags": [ + "统一接口", + "标签管理" + ], + "summary": "Remove Tag", + "description": "移除好友标签", + "operationId": "remove_tag_api_v3_tag_remove_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/RemoveTagRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Remove Tag Api V3 Tag Remove Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/tag/create": { + "post": { + "tags": [ + "统一接口", + "标签管理" + ], + "summary": "Create Tag", + "description": "创建标签", + "operationId": "create_tag_api_v3_tag_create_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/CreateTagRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Create Tag Api V3 Tag Create Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/tag/delete": { + "post": { + "tags": [ + "统一接口", + "标签管理" + ], + "summary": "Delete Tag", + "description": "删除标签", + "operationId": "delete_tag_api_v3_tag_delete_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/DeleteTagRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Delete Tag Api V3 Tag Delete Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/tag/list": { + "get": { + "tags": [ + "统一接口", + "标签管理" + ], + "summary": "Get Tag List", + "description": "获取标签列表", + "operationId": "get_tag_list_api_v3_tag_list_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Tag List Api V3 Tag List Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/tag/users": { + "post": { + "tags": [ + "统一接口", + "标签管理" + ], + "summary": "Get Users By Tag", + "description": "根据标签获取好友列表", + "operationId": "get_users_by_tag_api_v3_tag_users_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/GetUsersByTagRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Get Users By Tag Api V3 Tag Users Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/moments/post": { + "post": { + "tags": [ + "统一接口", + "朋友圈管理" + ], + "summary": "Post Moments", + "description": "发布朋友圈/瞬间(统一返回 200,业务失败用 success=false 表示,避免 502)", + "operationId": "post_moments_api_v3_moments_post_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/PostMomentsRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Post Moments Api V3 Moments Post Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/moments/like": { + "post": { + "tags": [ + "统一接口", + "朋友圈管理" + ], + "summary": "Like Moments", + "description": "点赞朋友圈", + "operationId": "like_moments_api_v3_moments_like_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/LikeMomentsRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Like Moments Api V3 Moments Like Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/moments/comment": { + "post": { + "tags": [ + "统一接口", + "朋友圈管理" + ], + "summary": "Comment Moments", + "description": "评论朋友圈", + "operationId": "comment_moments_api_v3_moments_comment_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/CommentMomentsRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Comment Moments Api V3 Moments Comment Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/moments/list": { + "post": { + "tags": [ + "统一接口", + "朋友圈管理" + ], + "summary": "Get Moments", + "description": "获取朋友圈列表", + "operationId": "get_moments_api_v3_moments_list_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/GetMomentsRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Get Moments Api V3 Moments List Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/message/forward": { + "post": { + "tags": [ + "统一接口", + "消息管理" + ], + "summary": "Forward Message", + "description": "转发消息", + "operationId": "forward_message_api_v3_message_forward_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ForwardMessageRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Forward Message Api V3 Message Forward Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/message/recall": { + "post": { + "tags": [ + "统一接口", + "消息管理" + ], + "summary": "Recall Message", + "description": "撤回最近一条消息", + "operationId": "recall_message_api_v3_message_recall_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/RecallMessageRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Recall Message Api V3 Message Recall Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/message/send-card": { + "post": { + "tags": [ + "统一接口", + "消息管理" + ], + "summary": "Send Card", + "description": "发送名片", + "operationId": "send_card_api_v3_message_send_card_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/SendCardRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Send Card Api V3 Message Send Card Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/profile/get": { + "get": { + "tags": [ + "统一接口", + "个人设置" + ], + "summary": "Get Profile", + "description": "获取当前微信账号资料", + "operationId": "get_profile_api_v3_profile_get_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": false, + "schema": { + "$ref": "#/components/schemas/Platform", + "default": "wechat" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Profile Api V3 Profile Get Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/profile/set-nickname": { + "post": { + "tags": [ + "统一接口", + "个人设置" + ], + "summary": "Set Nickname", + "description": "修改微信昵称", + "operationId": "set_nickname_api_v3_profile_set_nickname_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/SetNicknameRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Set Nickname Api V3 Profile Set Nickname Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/profile/set-signature": { + "post": { + "tags": [ + "统一接口", + "个人设置" + ], + "summary": "Set Signature", + "description": "修改个性签名", + "operationId": "set_signature_api_v3_profile_set_signature_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/SetSignatureRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Set Signature Api V3 Profile Set Signature Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/profile/set-avatar": { + "post": { + "tags": [ + "统一接口", + "个人设置" + ], + "summary": "Set Avatar", + "description": "修改头像", + "operationId": "set_avatar_api_v3_profile_set_avatar_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/SetAvatarRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Set Avatar Api V3 Profile Set Avatar Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/profile/set-gender": { + "post": { + "tags": [ + "统一接口", + "个人设置" + ], + "summary": "Set Gender", + "description": "设置性别", + "operationId": "set_gender_api_v3_profile_set_gender_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/SetGenderRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Set Gender Api V3 Profile Set Gender Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/profile/set-region": { + "post": { + "tags": [ + "统一接口", + "个人设置" + ], + "summary": "Set Region", + "description": "设置地区", + "operationId": "set_region_api_v3_profile_set_region_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/SetRegionRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Set Region Api V3 Profile Set Region Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/account/status": { + "get": { + "tags": [ + "统一接口", + "账号安全" + ], + "summary": "Check Account Status", + "description": "检查账号状态", + "operationId": "check_account_status_api_v3_account_status_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": false, + "schema": { + "$ref": "#/components/schemas/Platform", + "default": "wechat" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Check Account Status Api V3 Account Status Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/account/unblock": { + "post": { + "tags": [ + "统一接口", + "账号安全" + ], + "summary": "Unblock Account", + "description": "微信解封", + "operationId": "unblock_account_api_v3_account_unblock_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/UnblockAccountRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Unblock Account Api V3 Account Unblock Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/account/safety-center": { + "get": { + "tags": [ + "统一接口", + "账号安全" + ], + "summary": "Safety Center", + "description": "打开微信安全中心", + "operationId": "safety_center_api_v3_account_safety_center_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Safety Center Api V3 Account Safety Center Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/account/change-password": { + "post": { + "tags": [ + "统一接口", + "账号安全" + ], + "summary": "Change Password", + "description": "修改微信密码", + "operationId": "change_password_api_v3_account_change_password_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ChangePasswordRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Change Password Api V3 Account Change Password Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/favorites/add": { + "post": { + "tags": [ + "统一接口", + "收藏管理" + ], + "summary": "Add Favorite", + "description": "收藏消息", + "operationId": "add_favorite_api_v3_favorites_add_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/AddFavoriteRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Add Favorite Api V3 Favorites Add Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/favorites/list": { + "get": { + "tags": [ + "统一接口", + "收藏管理" + ], + "summary": "Get Favorites", + "description": "获取收藏列表", + "operationId": "get_favorites_api_v3_favorites_list_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": false, + "schema": { + "$ref": "#/components/schemas/Platform", + "default": "wechat" + } + }, + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 20, + "title": "Limit" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Favorites Api V3 Favorites List Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/chat/set-top": { + "post": { + "tags": [ + "统一接口", + "聊天设置" + ], + "summary": "Set Chat Top", + "description": "置顶/取消置顶聊天", + "operationId": "set_chat_top_api_v3_chat_set_top_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ChatSettingRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Set Chat Top Api V3 Chat Set Top Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/chat/set-mute": { + "post": { + "tags": [ + "统一接口", + "聊天设置" + ], + "summary": "Set Mute Chat", + "description": "消息免打扰", + "operationId": "set_mute_chat_api_v3_chat_set_mute_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ChatSettingRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Set Mute Chat Api V3 Chat Set Mute Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/chat/clear-history": { + "post": { + "tags": [ + "统一接口", + "聊天设置" + ], + "summary": "Clear Chat History", + "description": "清空聊天记录", + "operationId": "clear_chat_history_api_v3_chat_clear_history_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "user_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "User Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Clear Chat History Api V3 Chat Clear History Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/contacts/search": { + "get": { + "tags": [ + "统一接口", + "好友管理" + ], + "summary": "Search Contacts", + "description": "搜索联系人", + "operationId": "search_contacts_api_v3_contacts_search_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "keyword", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Keyword" + } + }, + { + "name": "platform", + "in": "query", + "required": false, + "schema": { + "$ref": "#/components/schemas/Platform", + "default": "wechat" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Search Contacts Api V3 Contacts Search Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/friend/info": { + "get": { + "tags": [ + "统一接口", + "好友管理" + ], + "summary": "Get Friend Info", + "description": "获取好友详细资料", + "operationId": "get_friend_info_api_v3_friend_info_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "user_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "User Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Friend Info Api V3 Friend Info Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/group/quit": { + "post": { + "tags": [ + "统一接口", + "群聊管理" + ], + "summary": "Quit Group", + "description": "退出群聊", + "operationId": "quit_group_api_v3_group_quit_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "group_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Group Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Quit Group Api V3 Group Quit Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/moments/delete": { + "post": { + "tags": [ + "统一接口", + "朋友圈管理" + ], + "summary": "Delete Moments", + "description": "删除朋友圈", + "operationId": "delete_moments_api_v3_moments_delete_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "post_index", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 0, + "title": "Post Index" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Delete Moments Api V3 Moments Delete Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/payment/red-packet": { + "post": { + "tags": [ + "统一接口", + "支付" + ], + "summary": "Send Red Packet", + "description": "发红包", + "operationId": "send_red_packet_api_v3_payment_red_packet_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/routers__unified__RedPacketRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Send Red Packet Api V3 Payment Red Packet Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/payment/transfer": { + "post": { + "tags": [ + "统一接口", + "支付" + ], + "summary": "Send Transfer", + "description": "转账", + "operationId": "send_transfer_api_v3_payment_transfer_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/routers__unified__TransferRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Send Transfer Api V3 Payment Transfer Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/miniprogram/open": { + "post": { + "tags": [ + "统一接口", + "小程序" + ], + "summary": "Open Mini Program", + "description": "打开小程序", + "operationId": "open_mini_program_api_v3_miniprogram_open_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "name", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Name" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Open Mini Program Api V3 Miniprogram Open Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/official-account/follow": { + "post": { + "tags": [ + "统一接口", + "公众号" + ], + "summary": "Follow Official Account", + "description": "关注公众号", + "operationId": "follow_official_account_api_v3_official_account_follow_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "account_name", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Account Name" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Follow Official Account Api V3 Official Account Follow Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/account/unblock-self": { + "post": { + "tags": [ + "统一接口", + "账号安全" + ], + "summary": "Unblock Self", + "description": "自助解封", + "operationId": "unblock_self_api_v3_account_unblock_self_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Unblock Self Api V3 Account Unblock Self Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/account/unblock-appeal": { + "post": { + "tags": [ + "统一接口", + "账号安全" + ], + "summary": "Unblock Appeal", + "description": "申诉解封", + "operationId": "unblock_appeal_api_v3_account_unblock_appeal_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Unblock Appeal Api V3 Account Unblock Appeal Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/account/restrictions": { + "get": { + "tags": [ + "统一接口", + "账号安全" + ], + "summary": "Check Restrictions", + "description": "检查当前功能限制", + "operationId": "check_restrictions_api_v3_account_restrictions_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Check Restrictions Api V3 Account Restrictions Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/account/appeal-restriction": { + "post": { + "tags": [ + "统一接口", + "账号安全" + ], + "summary": "Appeal Restriction", + "description": "申诉功能限制", + "operationId": "appeal_restriction_api_v3_account_appeal_restriction_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Appeal Restriction Api V3 Account Appeal Restriction Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/account/unblock-sms": { + "post": { + "tags": [ + "统一接口", + "账号安全" + ], + "summary": "Unblock With Sms", + "description": "短信验证解封", + "operationId": "unblock_with_sms_api_v3_account_unblock_sms_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "phone", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "Phone" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Unblock With Sms Api V3 Account Unblock Sms Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/video-channel/list": { + "get": { + "tags": [ + "统一接口", + "视频号" + ], + "summary": "Get Video List", + "description": "获取视频号列表", + "operationId": "get_video_list_api_v3_video_channel_list_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": false, + "schema": { + "$ref": "#/components/schemas/Platform", + "default": "wechat" + } + }, + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 10, + "title": "Limit" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Video List Api V3 Video Channel List Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/video-channel/like": { + "post": { + "tags": [ + "统一接口", + "视频号" + ], + "summary": "Like Video", + "description": "点赞视频", + "operationId": "like_video_api_v3_video_channel_like_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "index", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 0, + "title": "Index" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Like Video Api V3 Video Channel Like Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/video-channel/comment": { + "post": { + "tags": [ + "统一接口", + "视频号" + ], + "summary": "Comment Video", + "description": "评论视频", + "operationId": "comment_video_api_v3_video_channel_comment_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "index", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 0, + "title": "Index" + } + }, + { + "name": "comment", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "Comment" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Comment Video Api V3 Video Channel Comment Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/video-channel/follow": { + "post": { + "tags": [ + "统一接口", + "视频号" + ], + "summary": "Follow Video Creator", + "description": "关注视频号创作者", + "operationId": "follow_video_creator_api_v3_video_channel_follow_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "index", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 0, + "title": "Index" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Follow Video Creator Api V3 Video Channel Follow Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/video-channel/share": { + "post": { + "tags": [ + "统一接口", + "视频号" + ], + "summary": "Share Video", + "description": "分享视频", + "operationId": "share_video_api_v3_video_channel_share_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "index", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 0, + "title": "Index" + } + }, + { + "name": "to_id", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "To Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Share Video Api V3 Video Channel Share Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/scan/qr-code": { + "post": { + "tags": [ + "统一接口", + "扫一扫" + ], + "summary": "Scan Qr Code", + "description": "扫描二维码", + "operationId": "scan_qr_code_api_v3_scan_qr_code_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Scan Qr Code Api V3 Scan Qr Code Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/scan/add-friend": { + "post": { + "tags": [ + "统一接口", + "扫一扫" + ], + "summary": "Scan Add Friend", + "description": "扫码加好友", + "operationId": "scan_add_friend_api_v3_scan_add_friend_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Scan Add Friend Api V3 Scan Add Friend Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/scan/my-qr": { + "get": { + "tags": [ + "统一接口", + "扫一扫" + ], + "summary": "Show My Qr", + "description": "显示我的二维码", + "operationId": "show_my_qr_api_v3_scan_my_qr_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Show My Qr Api V3 Scan My Qr Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/scan/extract-qr": { + "post": { + "tags": [ + "统一接口", + "扫一扫" + ], + "summary": "Extract Qr From Image", + "description": "从图片识别二维码", + "operationId": "extract_qr_from_image_api_v3_scan_extract_qr_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Extract Qr From Image Api V3 Scan Extract Qr Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/payment/code": { + "get": { + "tags": [ + "统一接口", + "支付" + ], + "summary": "Show Payment Code", + "description": "显示付款码", + "operationId": "show_payment_code_api_v3_payment_code_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Show Payment Code Api V3 Payment Code Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/payment/receive": { + "post": { + "tags": [ + "统一接口", + "支付" + ], + "summary": "Receive Payment", + "description": "收款", + "operationId": "receive_payment_api_v3_payment_receive_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "amount", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "Amount" + } + }, + { + "name": "desc", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "Desc" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Receive Payment Api V3 Payment Receive Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/payment/wallet": { + "get": { + "tags": [ + "统一接口", + "支付" + ], + "summary": "View Wallet", + "description": "查看钱包", + "operationId": "view_wallet_api_v3_payment_wallet_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response View Wallet Api V3 Payment Wallet Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/payment/transactions": { + "get": { + "tags": [ + "统一接口", + "支付" + ], + "summary": "View Transactions", + "description": "查看账单", + "operationId": "view_transactions_api_v3_payment_transactions_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 20, + "title": "Limit" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response View Transactions Api V3 Payment Transactions Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/payment/receive-red-packet": { + "post": { + "tags": [ + "统一接口", + "支付" + ], + "summary": "Receive Red Packet", + "description": "领取红包", + "operationId": "receive_red_packet_api_v3_payment_receive_red_packet_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "from_id", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "From Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Receive Red Packet Api V3 Payment Receive Red Packet Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/call/voice": { + "post": { + "tags": [ + "统一接口", + "通话" + ], + "summary": "Voice Call", + "description": "语音通话", + "operationId": "voice_call_api_v3_call_voice_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "user_id", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "User Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Voice Call Api V3 Call Voice Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/call/video": { + "post": { + "tags": [ + "统一接口", + "通话" + ], + "summary": "Video Call", + "description": "视频通话", + "operationId": "video_call_api_v3_call_video_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "user_id", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "User Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Video Call Api V3 Call Video Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/mass-send": { + "post": { + "tags": [ + "统一接口", + "群发助手" + ], + "summary": "Mass Send", + "description": "群发消息", + "operationId": "mass_send_api_v3_mass_send_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/MassSendRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Mass Send Api V3 Mass Send Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/search/wechat": { + "get": { + "tags": [ + "统一接口", + "搜一搜" + ], + "summary": "Wechat Search", + "description": "搜一搜", + "operationId": "wechat_search_api_v3_search_wechat_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "keyword", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "Keyword" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Wechat Search Api V3 Search Wechat Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/discover/top-stories": { + "get": { + "tags": [ + "统一接口", + "看一看" + ], + "summary": "Top Stories", + "description": "看一看", + "operationId": "top_stories_api_v3_discover_top_stories_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Top Stories Api V3 Discover Top Stories Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat-sport/steps": { + "get": { + "tags": [ + "统一接口", + "微信运动" + ], + "summary": "Get Steps", + "description": "获取步数", + "operationId": "get_steps_api_v3_wechat_sport_steps_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": false, + "schema": { + "$ref": "#/components/schemas/Platform", + "default": "wechat" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Steps Api V3 Wechat Sport Steps Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat-sport/like-steps": { + "post": { + "tags": [ + "统一接口", + "微信运动" + ], + "summary": "Like Steps", + "description": "点赞步数", + "operationId": "like_steps_api_v3_wechat_sport_like_steps_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "user_id", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "User Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Like Steps Api V3 Wechat Sport Like Steps Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/location/send": { + "post": { + "tags": [ + "统一接口", + "位置" + ], + "summary": "Send Location", + "description": "发送位置", + "operationId": "send_location_api_v3_location_send_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "user_id", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "User Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Send Location Api V3 Location Send Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/location/share-realtime": { + "post": { + "tags": [ + "统一接口", + "位置" + ], + "summary": "Share Real Time Location", + "description": "共享实时位置", + "operationId": "share_real_time_location_api_v3_location_share_realtime_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "user_id", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "User Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Share Real Time Location Api V3 Location Share Realtime Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/emoji/send": { + "post": { + "tags": [ + "统一接口", + "表情" + ], + "summary": "Send Emoji", + "description": "发送表情", + "operationId": "send_emoji_api_v3_emoji_send_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "user_id", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "User Id" + } + }, + { + "name": "emoji_name", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "Emoji Name" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Send Emoji Api V3 Emoji Send Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/emoji/stickers": { + "get": { + "tags": [ + "统一接口", + "表情" + ], + "summary": "Get Sticker List", + "description": "获取表情包列表", + "operationId": "get_sticker_list_api_v3_emoji_stickers_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": false, + "schema": { + "$ref": "#/components/schemas/Platform", + "default": "wechat" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Sticker List Api V3 Emoji Stickers Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/moments/set-cover": { + "post": { + "tags": [ + "统一接口", + "朋友圈管理" + ], + "summary": "Set Moments Cover", + "description": "设置朋友圈封面", + "operationId": "set_moments_cover_api_v3_moments_set_cover_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Set Moments Cover Api V3 Moments Set Cover Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/moments/set-privacy": { + "post": { + "tags": [ + "统一接口", + "朋友圈管理" + ], + "summary": "Set Moments Privacy", + "description": "设置朋友圈可见天数", + "operationId": "set_moments_privacy_api_v3_moments_set_privacy_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "days", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 180, + "title": "Days" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Set Moments Privacy Api V3 Moments Set Privacy Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/moments/share-link": { + "post": { + "tags": [ + "统一接口", + "朋友圈管理" + ], + "summary": "Share Link To Moments", + "description": "分享链接到朋友圈", + "operationId": "share_link_to_moments_api_v3_moments_share_link_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "url", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "Url" + } + }, + { + "name": "title", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "Title" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Share Link To Moments Api V3 Moments Share Link Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/message/voice": { + "post": { + "tags": [ + "统一接口", + "消息管理" + ], + "summary": "Send Voice Message", + "description": "发送语音消息", + "operationId": "send_voice_message_api_v3_message_voice_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "user_id", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "User Id" + } + }, + { + "name": "duration", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 3, + "title": "Duration" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Send Voice Message Api V3 Message Voice Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/file/send": { + "post": { + "tags": [ + "统一接口", + "文件管理" + ], + "summary": "Send File", + "description": "发送文件", + "operationId": "send_file_api_v3_file_send_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "user_id", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "User Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Send File Api V3 File Send Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/file/download": { + "post": { + "tags": [ + "统一接口", + "文件管理" + ], + "summary": "Download File", + "description": "下载文件", + "operationId": "download_file_api_v3_file_download_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "user_id", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "User Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Download File Api V3 File Download Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/settings/do-not-disturb": { + "post": { + "tags": [ + "统一接口", + "设置" + ], + "summary": "Toggle Dnd", + "description": "勿扰模式", + "operationId": "toggle_dnd_api_v3_settings_do_not_disturb_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + }, + { + "name": "enable", + "in": "query", + "required": false, + "schema": { + "type": "boolean", + "default": true, + "title": "Enable" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Toggle Dnd Api V3 Settings Do Not Disturb Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/settings/clear-cache": { + "post": { + "tags": [ + "统一接口", + "设置" + ], + "summary": "Clear Cache", + "description": "清理缓存", + "operationId": "clear_cache_api_v3_settings_clear_cache_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Clear Cache Api V3 Settings Clear Cache Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/settings/check-update": { + "post": { + "tags": [ + "统一接口", + "设置" + ], + "summary": "Check Update", + "description": "检查更新", + "operationId": "check_update_api_v3_settings_check_update_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Check Update Api V3 Settings Check Update Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/settings/logout": { + "post": { + "tags": [ + "统一接口", + "设置" + ], + "summary": "Logout", + "description": "退出登录", + "operationId": "logout_api_v3_settings_logout_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Logout Api V3 Settings Logout Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/settings/switch-account": { + "post": { + "tags": [ + "统一接口", + "设置" + ], + "summary": "Switch Account", + "description": "切换账号", + "operationId": "switch_account_api_v3_settings_switch_account_post", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": true, + "schema": { + "$ref": "#/components/schemas/Platform" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Switch Account Api V3 Settings Switch Account Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/auto-register/full": { + "post": { + "tags": [ + "统一接口", + "自动注册" + ], + "summary": "Auto Register Full", + "description": "全自动微信注册 — 一键完成\n\n流程:\n1. 检测微信登录状态\n2. 未登录 → 自动从 SIM 获取手机号 → 注册\n3. 自动读取短信验证码 → 填写\n4. 设置昵称/密码 → 完成注册\n5. 可选:发送测试消息", + "operationId": "auto_register_full_api_v3_auto_register_full_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/AutoRegisterRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Auto Register Full Api V3 Auto Register Full Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/auto-register/check-state": { + "post": { + "tags": [ + "统一接口", + "自动注册" + ], + "summary": "Check Wechat Login State", + "description": "检查微信登录状态(已登录/登录页/注册页/未安装)", + "operationId": "check_wechat_login_state_api_v3_auto_register_check_state_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/CheckLoginStateRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Check Wechat Login State Api V3 Auto Register Check State Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/auto-register/get-sim-phone": { + "post": { + "tags": [ + "统一接口", + "自动注册" + ], + "summary": "Get Sim Phone", + "description": "从设备 SIM 卡获取手机号", + "operationId": "get_sim_phone_api_v3_auto_register_get_sim_phone_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/GetSimPhoneRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Get Sim Phone Api V3 Auto Register Get Sim Phone Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/anti-ban/dashboard": { + "get": { + "tags": [ + "统一接口" + ], + "summary": "Anti Ban Dashboard", + "description": "防封风控中心:汇总全局限流/账号生命周期/指纹碰撞状态", + "operationId": "anti_ban_dashboard_api_v3_anti_ban_dashboard_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/api/v3/anti-ban/device/{device_id}": { + "get": { + "tags": [ + "统一接口" + ], + "summary": "Anti Ban Device Detail", + "description": "单设备防封详情", + "operationId": "anti_ban_device_detail_api_v3_anti_ban_device__device_id__get", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/agent/execute": { + "post": { + "tags": [ + "AI Agent" + ], + "summary": "Execute Task", + "description": "执行自然语言任务(自动选择 WebSocket Agent 或 ADB 直连模式)\n\n示例任务:\n- \"打开微信\"\n- \"回主页\"\n- \"点击 发现\"\n- \"输入 你好\"", + "operationId": "execute_task_api_v3_agent_execute_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ExecuteTaskRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Execute Task Api V3 Agent Execute Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/agent/status/{device_id}": { + "get": { + "tags": [ + "AI Agent" + ], + "summary": "Get Agent Status", + "description": "获取Agent状态", + "operationId": "get_agent_status_api_v3_agent_status__device_id__get", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Agent Status Api V3 Agent Status Device Id Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/agent/stop/{device_id}": { + "post": { + "tags": [ + "AI Agent" + ], + "summary": "Stop Agent", + "description": "停止正在执行的Agent任务", + "operationId": "stop_agent_api_v3_agent_stop__device_id__post", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Stop Agent Api V3 Agent Stop Device Id Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/ai/status": { + "get": { + "tags": [ + "AI Agent" + ], + "summary": "Ai Status", + "description": "获取 AI 引擎状态", + "operationId": "ai_status_api_v3_ai_status_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Ai Status Api V3 Ai Status Get" + } + } + } + } + } + } + }, + "/api/v3/ai/chat": { + "post": { + "tags": [ + "AI Agent" + ], + "summary": "Ai Chat", + "description": "AI 对话控制手机 —— 核心端点\n用户输入自然语言,AI 返回并执行操作", + "operationId": "ai_chat_api_v3_ai_chat_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/AIChatRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Ai Chat Api V3 Ai Chat Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/ai/brain/skill-registry": { + "get": { + "tags": [ + "AI Agent" + ], + "summary": "Get Skill Registry", + "description": "AI Brain 技能注册表 — 返回所有可用技能、模块、操作的完整清单", + "operationId": "get_skill_registry_api_v3_ai_brain_skill_registry_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/api/v3/ai/brain/dashboard": { + "get": { + "tags": [ + "AI Agent" + ], + "summary": "Ai Brain Dashboard", + "description": "AI Brain 仪表盘 — 汇总 AI Brain 在全部设备上的状态", + "operationId": "ai_brain_dashboard_api_v3_ai_brain_dashboard_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/api/v3/ai/brain/execute-script": { + "post": { + "tags": [ + "AI Agent" + ], + "summary": "Execute Brain Script", + "description": "AI Brain 脚本执行器 — 向指定设备发送技能脚本\nBody: {device_id, script, action, params, channel?}", + "operationId": "execute_brain_script_api_v3_ai_brain_execute_script_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Request" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/ai/brain/batch-execute": { + "post": { + "tags": [ + "AI Agent" + ], + "summary": "Batch Execute Script", + "description": "AI Brain 批量脚本执行 — 向多台设备同时发送相同脚本\nBody: {device_ids: [...], script, action, params}", + "operationId": "batch_execute_script_api_v3_ai_brain_batch_execute_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Request" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/v1/chat/completions": { + "post": { + "tags": [ + "AI Agent" + ], + "summary": "Openai Proxy", + "description": "OpenAI 兼容端点 —— 代理到本地 Ollama\nOpenClaw 可以配置 baseUrl 指向这里", + "operationId": "openai_proxy_api_v3_v1_chat_completions_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Request" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Openai Proxy Api V3 V1 Chat Completions Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/adb/devices": { + "get": { + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "summary": "List Devices", + "description": "获取所有ADB设备", + "operationId": "list_devices_api_v3_adb_devices_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/api/v3/adb/scan": { + "get": { + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "summary": "Scan Devices", + "description": "扫描设备(含未授权设备的完整信息)", + "operationId": "scan_devices_api_v3_adb_scan_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + }, + "post": { + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "summary": "Scan Devices", + "description": "扫描设备(含未授权设备的完整信息)", + "operationId": "scan_devices_api_v3_adb_scan_post", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/api/v3/adb/devices/{serial}": { + "get": { + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "summary": "Get Device Info", + "description": "获取设备详情", + "operationId": "get_device_info_api_v3_adb_devices__serial__get", + "parameters": [ + { + "name": "serial", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Serial" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/adb/devices/{serial}/screenshot": { + "post": { + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "summary": "Screenshot", + "description": "截图", + "operationId": "screenshot_api_v3_adb_devices__serial__screenshot_post", + "parameters": [ + { + "name": "serial", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Serial" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/adb/devices/{serial}/click": { + "post": { + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "summary": "Click", + "description": "点击坐标", + "operationId": "click_api_v3_adb_devices__serial__click_post", + "parameters": [ + { + "name": "serial", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Serial" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ClickRequest" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/adb/devices/{serial}/click-text": { + "post": { + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "summary": "Click Text", + "description": "点击文字", + "operationId": "click_text_api_v3_adb_devices__serial__click_text_post", + "parameters": [ + { + "name": "serial", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Serial" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/routers__adb__ClickTextRequest" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/adb/devices/{serial}/input": { + "post": { + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "summary": "Input Text", + "description": "输入文字", + "operationId": "input_text_api_v3_adb_devices__serial__input_post", + "parameters": [ + { + "name": "serial", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Serial" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/routers__adb__InputRequest" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/adb/devices/{serial}/swipe": { + "post": { + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "summary": "Swipe", + "description": "滑动", + "operationId": "swipe_api_v3_adb_devices__serial__swipe_post", + "parameters": [ + { + "name": "serial", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Serial" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/SwipeRequest" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/adb/devices/{serial}/key": { + "post": { + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "summary": "Press Key", + "description": "按键", + "operationId": "press_key_api_v3_adb_devices__serial__key_post", + "parameters": [ + { + "name": "serial", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Serial" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/KeyRequest" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/adb/devices/{serial}/app/start": { + "post": { + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "summary": "Start App", + "description": "启动APP", + "operationId": "start_app_api_v3_adb_devices__serial__app_start_post", + "parameters": [ + { + "name": "serial", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Serial" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/AppRequest" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/adb/devices/{serial}/app/stop": { + "post": { + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "summary": "Stop App", + "description": "停止APP", + "operationId": "stop_app_api_v3_adb_devices__serial__app_stop_post", + "parameters": [ + { + "name": "serial", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Serial" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/AppRequest" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/adb/devices/{serial}/app/current": { + "get": { + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "summary": "Current App", + "description": "获取当前APP", + "operationId": "current_app_api_v3_adb_devices__serial__app_current_get", + "parameters": [ + { + "name": "serial", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Serial" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/adb/devices/{serial}/app/list": { + "get": { + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "summary": "List Apps", + "description": "获取已安装APP", + "operationId": "list_apps_api_v3_adb_devices__serial__app_list_get", + "parameters": [ + { + "name": "serial", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Serial" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/adb/devices/{serial}/ui-tree": { + "get": { + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "summary": "Get Ui Tree", + "description": "获取UI树(XML 已做 JSON-safe 转义)", + "operationId": "get_ui_tree_api_v3_adb_devices__serial__ui_tree_get", + "parameters": [ + { + "name": "serial", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Serial" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/experience/statistics": { + "get": { + "tags": [ + "经验库", + "经验库" + ], + "summary": "Get Statistics", + "description": "获取经验库统计信息", + "operationId": "get_statistics_api_v3_experience_statistics_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/api/v3/experience/operations": { + "get": { + "tags": [ + "经验库", + "经验库" + ], + "summary": "Get Operations", + "description": "获取最近的操作记录", + "operationId": "get_operations_api_v3_experience_operations_get", + "parameters": [ + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 100, + "title": "Limit" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/experience/operations/record": { + "post": { + "tags": [ + "经验库", + "经验库" + ], + "summary": "Record Operation", + "description": "记录一次操作", + "operationId": "record_operation_api_v3_experience_operations_record_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/RecordOperation" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/experience/shortcuts": { + "get": { + "tags": [ + "经验库", + "经验库" + ], + "summary": "List Shortcuts", + "description": "列出所有快捷操作", + "operationId": "list_shortcuts_api_v3_experience_shortcuts_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + }, + "post": { + "tags": [ + "经验库", + "经验库" + ], + "summary": "Create Shortcut", + "description": "创建快捷操作", + "operationId": "create_shortcut_api_v3_experience_shortcuts_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ShortcutCreate" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/experience/shortcuts/{name}": { + "get": { + "tags": [ + "经验库", + "经验库" + ], + "summary": "Get Shortcut", + "description": "获取快捷操作详情", + "operationId": "get_shortcut_api_v3_experience_shortcuts__name__get", + "parameters": [ + { + "name": "name", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Name" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/experience/shortcuts/{name}/execute/{device_id}": { + "post": { + "tags": [ + "经验库", + "经验库" + ], + "summary": "Execute Shortcut", + "description": "执行快捷操作\n\n示例: 执行微信发消息\nPOST /api/v3/experience/shortcuts/wechat_send_message/execute/emulator-5554\n{\n \"variables\": {\n \"contact\": \"张三\",\n \"message\": \"你好\"\n }\n}", + "operationId": "execute_shortcut_api_v3_experience_shortcuts__name__execute__device_id__post", + "parameters": [ + { + "name": "name", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Name" + } + }, + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ShortcutExecute" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/experience/suggest/coordinates": { + "get": { + "tags": [ + "经验库", + "经验库" + ], + "summary": "Suggest Coordinates", + "description": "获取坐标建议\n\n根据历史操作记录,建议某个APP中某个文字元素的坐标", + "operationId": "suggest_coordinates_api_v3_experience_suggest_coordinates_get", + "parameters": [ + { + "name": "app", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "App" + } + }, + { + "name": "text", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Text" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/experience/success-rate": { + "get": { + "tags": [ + "经验库", + "经验库" + ], + "summary": "Get Success Rate", + "description": "获取某操作的成功率", + "operationId": "get_success_rate_api_v3_experience_success_rate_get", + "parameters": [ + { + "name": "app", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "App" + } + }, + { + "name": "action", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Action" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/experience/average-duration": { + "get": { + "tags": [ + "经验库", + "经验库" + ], + "summary": "Get Average Duration", + "description": "获取某操作的平均耗时", + "operationId": "get_average_duration_api_v3_experience_average_duration_get", + "parameters": [ + { + "name": "app", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "App" + } + }, + { + "name": "action", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Action" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/experience/elements": { + "get": { + "tags": [ + "经验库", + "经验库" + ], + "summary": "Get Learned Elements", + "description": "获取学习到的APP元素", + "operationId": "get_learned_elements_api_v3_experience_elements_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/api/v3/experience/elements/{app}": { + "get": { + "tags": [ + "经验库", + "经验库" + ], + "summary": "Get App Elements", + "description": "获取某APP学习到的元素", + "operationId": "get_app_elements_api_v3_experience_elements__app__get", + "parameters": [ + { + "name": "app", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "App" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/projects": { + "get": { + "tags": [ + "项目管理", + "项目管理" + ], + "summary": "List Projects", + "description": "获取所有项目列表", + "operationId": "list_projects_api_v3_projects_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/api/v3/projects/{project_id}": { + "get": { + "tags": [ + "项目管理", + "项目管理" + ], + "summary": "Get Project", + "description": "获取项目详情", + "operationId": "get_project_api_v3_projects__project_id__get", + "parameters": [ + { + "name": "project_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Project Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/projects/{project_id}/devices": { + "get": { + "tags": [ + "项目管理", + "项目管理" + ], + "summary": "Get Project Devices", + "description": "获取项目下所有在线设备", + "operationId": "get_project_devices_api_v3_projects__project_id__devices_get", + "parameters": [ + { + "name": "project_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Project Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/projects/{project_id}/broadcast": { + "post": { + "tags": [ + "项目管理", + "项目管理" + ], + "summary": "Broadcast Command", + "description": "向项目下所有设备广播命令(不等待响应)\n\n适用于:打开APP、发送通知等不需要等待结果的操作", + "operationId": "broadcast_command_api_v3_projects__project_id__broadcast_post", + "parameters": [ + { + "name": "project_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Project Id" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ExecuteCommand" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/projects/{project_id}/execute": { + "post": { + "tags": [ + "项目管理", + "项目管理" + ], + "summary": "Execute Command", + "description": "在项目下所有设备执行命令(等待响应)\n\n适用于:需要获取执行结果的操作", + "operationId": "execute_command_api_v3_projects__project_id__execute_post", + "parameters": [ + { + "name": "project_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Project Id" + } + }, + { + "name": "timeout", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 30, + "title": "Timeout" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ExecuteCommand" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/projects/{project_id}/devices/{device_id}/execute": { + "post": { + "tags": [ + "项目管理", + "项目管理" + ], + "summary": "Execute On Device", + "description": "在指定设备上执行命令", + "operationId": "execute_on_device_api_v3_projects__project_id__devices__device_id__execute_post", + "parameters": [ + { + "name": "project_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Project Id" + } + }, + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "timeout", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 30, + "title": "Timeout" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ExecuteCommand" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/qrcode/generate": { + "post": { + "tags": [ + "二维码", + "二维码" + ], + "summary": "Generate Qrcode", + "description": "生成项目绑定二维码\n\n请求体:\n{\n \"project_id\": \"project_001\",\n \"project_name\": \"测试项目\",\n \"server\": \"ws://sdk.quwanzhi.com:8899/ws/device\",\n \"pwa\": \"\"\n}\n\n返回: Base64编码的PNG图片", + "operationId": "generate_qrcode_api_v3_qrcode_generate_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ProjectBindConfig" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/qrcode/image/{project_id}": { + "get": { + "tags": [ + "二维码", + "二维码" + ], + "summary": "Get Qrcode Image", + "description": "直接获取二维码图片\n\n示例: GET /api/v3/qrcode/image/project_001?project_name=测试项目\n\n返回: PNG图片", + "operationId": "get_qrcode_image_api_v3_qrcode_image__project_id__get", + "parameters": [ + { + "name": "project_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Project Id" + } + }, + { + "name": "project_name", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "Project Name" + } + }, + { + "name": "server", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "ws://sdk.quwanzhi.com:8899/ws/device", + "title": "Server" + } + }, + { + "name": "pwa", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "Pwa" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/qrcode/html/{project_id}": { + "get": { + "tags": [ + "二维码", + "二维码" + ], + "summary": "Get Qrcode Html", + "description": "获取带样式的二维码HTML页面\n\n示例: GET /api/v3/qrcode/html/project_001?project_name=测试项目\n\n返回: HTML页面,可直接打印或分享", + "operationId": "get_qrcode_html_api_v3_qrcode_html__project_id__get", + "parameters": [ + { + "name": "project_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Project Id" + } + }, + { + "name": "project_name", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "Project Name" + } + }, + { + "name": "server", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "ws://sdk.quwanzhi.com:8899/ws/device", + "title": "Server" + } + }, + { + "name": "pwa", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "Pwa" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/voice/command": { + "post": { + "tags": [ + "语音控制", + "语音控制" + ], + "summary": "Voice Command", + "description": "处理语音命令\n\n接收文本命令,解析意图,可选择立即执行\n\n示例:\nPOST /api/v3/voice/command\n{\n \"text\": \"打开微信\",\n \"device_id\": \"device_001\",\n \"execute\": true\n}", + "operationId": "voice_command_api_v3_voice_command_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/VoiceCommandRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/VoiceCommandResponse" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/voice/parse": { + "post": { + "tags": [ + "语音控制", + "语音控制" + ], + "summary": "Parse Command", + "description": "仅解析命令,不执行\n\n用于预览AI解析结果", + "operationId": "parse_command_api_v3_voice_parse_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/VoiceCommandRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/voice/apps": { + "get": { + "tags": [ + "语音控制", + "语音控制" + ], + "summary": "Get Common Apps", + "description": "获取常用应用列表\n\n用于语音识别提示", + "operationId": "get_common_apps_api_v3_voice_apps_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/api/v3/capture/start": { + "post": { + "tags": [ + "抓包" + ], + "summary": "Api Start Capture", + "operationId": "api_start_capture_api_v3_capture_start_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/StartCaptureRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Api Start Capture Api V3 Capture Start Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/capture/stop": { + "post": { + "tags": [ + "抓包" + ], + "summary": "Api Stop Capture", + "operationId": "api_stop_capture_api_v3_capture_stop_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/StopCaptureRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Api Stop Capture Api V3 Capture Stop Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/capture/status/{device_id}": { + "get": { + "tags": [ + "抓包" + ], + "summary": "Api Capture Status", + "operationId": "api_capture_status_api_v3_capture_status__device_id__get", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Api Capture Status Api V3 Capture Status Device Id Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/capture/data/{device_id}": { + "get": { + "tags": [ + "抓包" + ], + "summary": "Api Capture Data", + "operationId": "api_capture_data_api_v3_capture_data__device_id__get", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 100, + "title": "Limit" + } + }, + { + "name": "since", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Since" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Api Capture Data Api V3 Capture Data Device Id Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/modules": { + "get": { + "tags": [ + "Hook模块管理" + ], + "summary": "List Modules", + "operationId": "list_modules_api_v3_modules_get", + "parameters": [ + { + "name": "enabled", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "boolean" + }, + { + "type": "null" + } + ], + "title": "Enabled" + } + }, + { + "name": "scope", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Scope" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + }, + "post": { + "tags": [ + "Hook模块管理" + ], + "summary": "Create Module", + "operationId": "create_module_api_v3_modules_post", + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ModuleUpsertRequest" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/modules/{module_id}": { + "get": { + "tags": [ + "Hook模块管理" + ], + "summary": "Get Module", + "operationId": "get_module_api_v3_modules__module_id__get", + "parameters": [ + { + "name": "module_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Module Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + }, + "put": { + "tags": [ + "Hook模块管理" + ], + "summary": "Update Module", + "operationId": "update_module_api_v3_modules__module_id__put", + "parameters": [ + { + "name": "module_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Module Id" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ModuleUpsertRequest" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + }, + "delete": { + "tags": [ + "Hook模块管理" + ], + "summary": "Delete Module", + "operationId": "delete_module_api_v3_modules__module_id__delete", + "parameters": [ + { + "name": "module_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Module Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/modules/{module_id}/scope": { + "put": { + "tags": [ + "Hook模块管理" + ], + "summary": "Set Module Scope", + "operationId": "set_module_scope_api_v3_modules__module_id__scope_put", + "parameters": [ + { + "name": "module_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Module Id" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ScopeUpdateRequest" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/modules/{module_id}/enable": { + "post": { + "tags": [ + "Hook模块管理" + ], + "summary": "Enable Module", + "operationId": "enable_module_api_v3_modules__module_id__enable_post", + "parameters": [ + { + "name": "module_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Module Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/modules/{module_id}/disable": { + "post": { + "tags": [ + "Hook模块管理" + ], + "summary": "Disable Module", + "operationId": "disable_module_api_v3_modules__module_id__disable_post", + "parameters": [ + { + "name": "module_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Module Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/devices/{device_id}/modules": { + "get": { + "tags": [ + "Hook模块管理" + ], + "summary": "Get Device Modules", + "operationId": "get_device_modules_api_v3_devices__device_id__modules_get", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/devices/{device_id}/modules/reload": { + "post": { + "tags": [ + "Hook模块管理" + ], + "summary": "Reload Device Modules", + "operationId": "reload_device_modules_api_v3_devices__device_id__modules_reload_post", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ReloadDeviceModulesRequest" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/devices/{device_id}/modules/{module_id}/logs": { + "get": { + "tags": [ + "Hook模块管理" + ], + "summary": "Get Device Module Logs", + "operationId": "get_device_module_logs_api_v3_devices__device_id__modules__module_id__logs_get", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "module_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Module Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/scripts": { + "get": { + "tags": [ + "Hook模块管理" + ], + "summary": "List Scripts", + "operationId": "list_scripts_api_v3_scripts_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + }, + "post": { + "tags": [ + "Hook模块管理" + ], + "summary": "Upload Script", + "operationId": "upload_script_api_v3_scripts_post", + "parameters": [ + { + "name": "module_id", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "wechat_hook_v1", + "title": "Module Id" + } + }, + { + "name": "version", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "1.0.0", + "title": "Version" + } + }, + { + "name": "description", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "Description" + } + } + ], + "requestBody": { + "required": true, + "content": { + "multipart/form-data": { + "schema": { + "$ref": "#/components/schemas/Body_upload_script_api_v3_scripts_post" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/scripts/{script_id}": { + "get": { + "tags": [ + "Hook模块管理" + ], + "summary": "Download Script", + "operationId": "download_script_api_v3_scripts__script_id__get", + "parameters": [ + { + "name": "script_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Script Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/scripts/{script_id}/deploy": { + "post": { + "tags": [ + "Hook模块管理" + ], + "summary": "Deploy Script", + "operationId": "deploy_script_api_v3_scripts__script_id__deploy_post", + "parameters": [ + { + "name": "script_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Script Id" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/routers__hook_modules__DeployScriptRequest" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/hook/events": { + "get": { + "tags": [ + "Hook模块管理" + ], + "summary": "List Hook Events", + "operationId": "list_hook_events_api_v3_hook_events_get", + "parameters": [ + { + "name": "event_type", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Event Type" + } + }, + { + "name": "device_id", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Device Id" + } + }, + { + "name": "platform", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Platform" + } + }, + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 100, + "title": "Limit" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + }, + "post": { + "tags": [ + "Hook模块管理" + ], + "summary": "Ingest Hook Event", + "operationId": "ingest_hook_event_api_v3_hook_events_post", + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Payload" + } + } + } + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/connection/protocol": { + "get": { + "tags": [ + "连接协议" + ], + "summary": "Get Connection Protocol", + "description": "连接方式协议:给前端/对接方直观看结构。", + "operationId": "get_connection_protocol_api_v3_connection_protocol_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Get Connection Protocol Api V3 Connection Protocol Get" + } + } + } + } + } + } + }, + "/api/v3/connection/status": { + "get": { + "tags": [ + "连接协议" + ], + "summary": "Get Connection Status", + "description": "实时连接状态:用于控制台展示。", + "operationId": "get_connection_status_api_v3_connection_status_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Get Connection Status Api V3 Connection Status Get" + } + } + } + } + } + } + }, + "/api/v3/connection/simulate/register": { + "post": { + "tags": [ + "连接协议" + ], + "summary": "Simulate Register", + "description": "协议联调:模拟设备 register(不建立真实 WS,仅写入状态面板)。", + "operationId": "simulate_register_api_v3_connection_simulate_register_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/SimRegisterRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Simulate Register Api V3 Connection Simulate Register Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/connection/simulate/heartbeat": { + "post": { + "tags": [ + "连接协议" + ], + "summary": "Simulate Heartbeat", + "description": "协议联调:模拟心跳。", + "operationId": "simulate_heartbeat_api_v3_connection_simulate_heartbeat_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/SimHeartbeatRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Simulate Heartbeat Api V3 Connection Simulate Heartbeat Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/connection/simulate/hook-event": { + "post": { + "tags": [ + "连接协议" + ], + "summary": "Simulate Hook Event", + "description": "协议联调:模拟 hook 事件写入并广播到事件流。", + "operationId": "simulate_hook_event_api_v3_connection_simulate_hook_event_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/SimHookEventRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Simulate Hook Event Api V3 Connection Simulate Hook Event Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/connection/modes/{device_id}": { + "get": { + "tags": [ + "连接协议" + ], + "summary": "Get Device Connection Modes", + "description": "获取设备所有控制模式的可用性与优先级。refresh=true 强制刷新缓存。", + "operationId": "get_device_connection_modes_api_v3_connection_modes__device_id__get", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "refresh", + "in": "query", + "required": false, + "schema": { + "type": "boolean", + "default": false, + "title": "Refresh" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Device Connection Modes Api V3 Connection Modes Device Id Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/connection/modes": { + "get": { + "tags": [ + "连接协议" + ], + "summary": "Get All Connection Modes", + "description": "获取所有已知设备的控制模式概览。", + "operationId": "get_all_connection_modes_api_v3_connection_modes_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Get All Connection Modes Api V3 Connection Modes Get" + } + } + } + } + } + } + }, + "/api/v3/gateway/v1/chat/completions": { + "post": { + "tags": [ + "外部对接网关", + "外部对接网关" + ], + "summary": "Openai Compatible Chat", + "description": "OpenAI 兼容的 Chat API —— 外部程序可像调用 GPT 一样控制手机。\n\n用法:把 base_url 改为 http://服务器:8899/api/v3/gateway/v1,\n即可用任何 OpenAI SDK 直接对接。", + "operationId": "openai_compatible_chat_api_v3_gateway_v1_chat_completions_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ChatRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/gateway/v1/models": { + "get": { + "tags": [ + "外部对接网关", + "外部对接网关" + ], + "summary": "List Models", + "description": "OpenAI 兼容 —— 列出可用模型", + "operationId": "list_models_api_v3_gateway_v1_models_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/api/v3/gateway/mcp/tools": { + "get": { + "tags": [ + "外部对接网关", + "外部对接网关" + ], + "summary": "Mcp List Tools", + "description": "MCP Protocol —— 列出所有可用工具", + "operationId": "mcp_list_tools_api_v3_gateway_mcp_tools_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/api/v3/gateway/mcp/call": { + "post": { + "tags": [ + "外部对接网关", + "外部对接网关" + ], + "summary": "Mcp Call Tool", + "description": "MCP Protocol —— 调用指定工具\n\n请求体: {\"name\": \"send_message\", \"arguments\": {\"to\": \"张三\", \"content\": \"你好\"}}", + "operationId": "mcp_call_tool_api_v3_gateway_mcp_call_post", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/api/v3/gateway/info": { + "get": { + "tags": [ + "外部对接网关", + "外部对接网关" + ], + "summary": "Gateway Info", + "description": "网关信息 —— 三种对接方式的入口和说明", + "operationId": "gateway_info_api_v3_gateway_info_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/api/v3/gateway/fleet/status": { + "get": { + "tags": [ + "外部对接网关", + "外部对接网关" + ], + "summary": "Fleet Status", + "description": "多设备总览 —— 所有设备的实时状态汇总", + "operationId": "fleet_status_api_v3_gateway_fleet_status_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/api/v3/gateway/fleet/broadcast": { + "post": { + "tags": [ + "外部对接网关", + "外部对接网关" + ], + "summary": "Fleet Broadcast", + "description": "向多台设备广播命令 —— 批量控制\n\n如果 device_ids 为空,则向所有在线设备广播。", + "operationId": "fleet_broadcast_api_v3_gateway_fleet_broadcast_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/FleetCommandRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/gateway/fleet/group": { + "post": { + "tags": [ + "外部对接网关", + "外部对接网关" + ], + "summary": "Create Device Group", + "description": "创建设备分组 —— 方便批量管理", + "operationId": "create_device_group_api_v3_gateway_fleet_group_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/DeviceGroupRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/gateway/fleet/groups": { + "get": { + "tags": [ + "外部对接网关", + "外部对接网关" + ], + "summary": "List Device Groups", + "description": "列出所有设备分组", + "operationId": "list_device_groups_api_v3_gateway_fleet_groups_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/api/v3/gateway/journey/{device_id}": { + "get": { + "tags": [ + "外部对接网关", + "外部对接网关" + ], + "summary": "Get Device Journey", + "description": "获取设备的 AI 旅程 —— 每台手机的操作历史和 AI 决策记录", + "operationId": "get_device_journey_api_v3_gateway_journey__device_id__get", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 50, + "title": "Limit" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/gateway/journey": { + "get": { + "tags": [ + "外部对接网关", + "外部对接网关" + ], + "summary": "Get All Journeys", + "description": "获取所有设备的 AI 旅程", + "operationId": "get_all_journeys_api_v3_gateway_journey_get", + "parameters": [ + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 100, + "title": "Limit" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/registry/nodes/register": { + "post": { + "tags": [ + "多服务器注册中心", + "多服务器注册中心" + ], + "summary": "Register Node", + "operationId": "register_node_api_v3_registry_nodes_register_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/RegisterNodeBody" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Register Node Api V3 Registry Nodes Register Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/registry/nodes/heartbeat": { + "post": { + "tags": [ + "多服务器注册中心", + "多服务器注册中心" + ], + "summary": "Node Heartbeat", + "operationId": "node_heartbeat_api_v3_registry_nodes_heartbeat_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HeartbeatBody" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Node Heartbeat Api V3 Registry Nodes Heartbeat Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/registry/nodes": { + "get": { + "tags": [ + "多服务器注册中心", + "多服务器注册中心" + ], + "summary": "List Nodes", + "operationId": "list_nodes_api_v3_registry_nodes_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response List Nodes Api V3 Registry Nodes Get" + } + } + } + } + } + } + }, + "/api/v3/registry/nodes/{node_id}": { + "delete": { + "tags": [ + "多服务器注册中心", + "多服务器注册中心" + ], + "summary": "Remove Node", + "operationId": "remove_node_api_v3_registry_nodes__node_id__delete", + "parameters": [ + { + "name": "node_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Node Id" + } + }, + { + "name": "token", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Token" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Remove Node Api V3 Registry Nodes Node Id Delete" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/registry/fleet/aggregate": { + "get": { + "tags": [ + "多服务器注册中心", + "多服务器注册中心" + ], + "summary": "Fleet Aggregate", + "description": "本机设备 + 已登记节点 + WORKPHONE_REGISTRY_PEERS 静态节点的合并视图。", + "operationId": "fleet_aggregate_api_v3_registry_fleet_aggregate_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Fleet Aggregate Api V3 Registry Fleet Aggregate Get" + } + } + } + } + } + } + }, + "/api/v3/registry/info": { + "get": { + "tags": [ + "多服务器注册中心", + "多服务器注册中心" + ], + "summary": "Registry Info", + "operationId": "registry_info_api_v3_registry_info_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Registry Info Api V3 Registry Info Get" + } + } + } + } + } + } + }, + "/api/v3/discovery/server-info": { + "get": { + "tags": [ + "设备发现", + "discovery" + ], + "summary": "Get Server Info", + "description": "返回本服务器信息(IP、端口、WS 地址等)", + "operationId": "get_server_info_api_v3_discovery_server_info_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/api/v3/discovery/scan-lan": { + "post": { + "tags": [ + "设备发现", + "discovery" + ], + "summary": "Scan Lan", + "description": "扫描局域网中的 SDK 服务器", + "operationId": "scan_lan_api_v3_discovery_scan_lan_post", + "parameters": [ + { + "name": "timeout", + "in": "query", + "required": false, + "schema": { + "type": "number", + "default": 3.0, + "title": "Timeout" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/discovery/last-scan": { + "get": { + "tags": [ + "设备发现", + "discovery" + ], + "summary": "Get Last Scan", + "description": "获取上次扫描结果", + "operationId": "get_last_scan_api_v3_discovery_last_scan_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/api/v3/discovery/listen-beacon": { + "post": { + "tags": [ + "设备发现", + "discovery" + ], + "summary": "Listen Beacon", + "description": "监听 UDP beacon 发现服务器", + "operationId": "listen_beacon_api_v3_discovery_listen_beacon_post", + "parameters": [ + { + "name": "timeout", + "in": "query", + "required": false, + "schema": { + "type": "number", + "default": 5.0, + "title": "Timeout" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/discovery/beacon/start": { + "post": { + "tags": [ + "设备发现", + "discovery" + ], + "summary": "Start Beacon", + "description": "启动 UDP beacon 广播", + "operationId": "start_beacon_api_v3_discovery_beacon_start_post", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/api/v3/discovery/beacon/stop": { + "post": { + "tags": [ + "设备发现", + "discovery" + ], + "summary": "Stop Beacon", + "description": "停止 UDP beacon 广播", + "operationId": "stop_beacon_api_v3_discovery_beacon_stop_post", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/api/v3/cunke-bao/config": { + "get": { + "tags": [ + "存客宝对接", + "存客宝对接" + ], + "summary": "Get Config", + "description": "查询当前存客宝配置(API Key 脱敏显示)", + "operationId": "get_config_api_v3_cunke_bao_config_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + }, + "post": { + "tags": [ + "存客宝对接", + "存客宝对接" + ], + "summary": "Set Config", + "description": "设置存客宝对接配置\n\n配置 API Key、接口地址、超时等参数,并启用/禁用服务。", + "operationId": "set_config_api_v3_cunke_bao_config_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/CKBConfigRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/cunke-bao/stats": { + "get": { + "tags": [ + "存客宝对接", + "存客宝对接" + ], + "summary": "Get Stats", + "description": "查询存客宝服务统计信息", + "operationId": "get_stats_api_v3_cunke_bao_stats_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/api/v3/cunke-bao/report-lead": { + "post": { + "tags": [ + "存客宝对接", + "存客宝对接" + ], + "summary": "Report Lead", + "description": "手动上报线索到存客宝\n\n可用于测试或特殊场景下的手动触发。", + "operationId": "report_lead_api_v3_cunke_bao_report_lead_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/LeadReportRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/cunke-bao/batch-contacts": { + "post": { + "tags": [ + "存客宝对接", + "存客宝对接" + ], + "summary": "Batch Report Contacts", + "description": "批量上报联系人到存客宝\n\n通常由 Frida Hook 获取通讯录后调用,支持后台异步处理。", + "operationId": "batch_report_contacts_api_v3_cunke_bao_batch_contacts_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/BatchContactRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/cunke-bao/hook/friend-add": { + "post": { + "tags": [ + "存客宝对接", + "存客宝对接", + "Frida Hook" + ], + "summary": "Hook Friend Add", + "description": "接收 Frida Hook 上报的新好友添加事件\n\n设备端 Agent 在检测到新好友添加时调用此接口,\n服务端将自动转换为存客宝线索并上报。", + "operationId": "hook_friend_add_api_v3_cunke_bao_hook_friend_add_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/FriendAddEventRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/cunke-bao/hook/group-change": { + "post": { + "tags": [ + "存客宝对接", + "存客宝对接", + "Frida Hook" + ], + "summary": "Hook Group Change", + "description": "接收 Frida Hook 上报的群变动事件\n\n设备端 Agent 在检测到群成员变动时调用此接口,\n服务端将自动处理并按需上报到存客宝。", + "operationId": "hook_group_change_api_v3_cunke_bao_hook_group_change_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/GroupChangeEventRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/cunke-bao/hook/batch-events": { + "post": { + "tags": [ + "存客宝对接", + "存客宝对接", + "Frida Hook" + ], + "summary": "Hook Batch Events", + "description": "批量接收 Frida Hook 事件\n\n设备端可将多个事件打包一次性上报,减少网络请求次数。\n支持的事件类型:friend_add / group_change / contact_update", + "operationId": "hook_batch_events_api_v3_cunke_bao_hook_batch_events_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array", + "title": "Events" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/frida/register": { + "post": { + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "summary": "Register Device", + "description": "注册 Frida 设备(手机端部署脚本自动调用)\n\n设备通过 WiFi 连接后,自动向服务器注册。", + "operationId": "register_device_api_v3_frida_register_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/DeviceRegisterRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Register Device Api V3 Frida Register Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/frida/unregister/{device_id}": { + "delete": { + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "summary": "Unregister Device", + "description": "注销设备", + "operationId": "unregister_device_api_v3_frida_unregister__device_id__delete", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Unregister Device Api V3 Frida Unregister Device Id Delete" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/frida/devices": { + "get": { + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "summary": "List Devices", + "description": "列出所有已注册的 Frida 设备", + "operationId": "list_devices_api_v3_frida_devices_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response List Devices Api V3 Frida Devices Get" + } + } + } + } + } + } + }, + "/api/v3/frida/device/{device_id}": { + "get": { + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "summary": "Get Device", + "description": "获取设备详情", + "operationId": "get_device_api_v3_frida_device__device_id__get", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Device Api V3 Frida Device Device Id Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/frida/connect": { + "post": { + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "summary": "Connect Device", + "description": "连接设备的 Frida(通过 WiFi TCP)\n\n向 Agent 发送连接指令,Agent 通过 WirelessBridge 连接本地 Frida。", + "operationId": "connect_device_api_v3_frida_connect_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/DeviceConnectRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Connect Device Api V3 Frida Connect Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/frida/disconnect/{device_id}": { + "post": { + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "summary": "Disconnect Device", + "description": "断开设备 Frida 连接", + "operationId": "disconnect_device_api_v3_frida_disconnect__device_id__post", + "parameters": [ + { + "name": "device_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Disconnect Device Api V3 Frida Disconnect Device Id Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/frida/execute": { + "post": { + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "summary": "Execute Command", + "description": "执行 Frida RPC 指令\n\n通过 WebSocket 将指令发送到 Agent,Agent 通过 WirelessBridge 执行 Frida RPC。\n支持 112 个微信操作(24 个模块)。", + "operationId": "execute_command_api_v3_frida_execute_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/CommandRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Execute Command Api V3 Frida Execute Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/frida/execute/batch": { + "post": { + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "summary": "Execute Batch", + "description": "批量执行指令", + "operationId": "execute_batch_api_v3_frida_execute_batch_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/BatchCommandRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Execute Batch Api V3 Frida Execute Batch Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/frida/deploy/script": { + "post": { + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "summary": "Generate Deploy Script", + "description": "生成 Frida 部署脚本\n\n返回可在 Termux 中直接执行的 shell 脚本。\n支持 Root(frida-server)和免Root(frida-gadget)两种模式。", + "operationId": "generate_deploy_script_api_v3_frida_deploy_script_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/DeployScriptRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Generate Deploy Script Api V3 Frida Deploy Script Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/frida/deploy/install-script": { + "get": { + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "summary": "Get Install Command", + "description": "获取一键安装命令\n\n返回可在 Termux 中直接执行的 curl 命令。", + "operationId": "get_install_command_api_v3_frida_deploy_install_script_get", + "parameters": [ + { + "name": "server_url", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "Server Url" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Install Command Api V3 Frida Deploy Install Script Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/frida/discover": { + "post": { + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "summary": "Discover Devices", + "description": "扫描局域网内的 Frida 设备\n\n扫描指定子网内运行 frida-server 的设备。", + "operationId": "discover_devices_api_v3_frida_discover_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/DiscoverRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Discover Devices Api V3 Frida Discover Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/frida/status": { + "get": { + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "summary": "Frida Status", + "description": "获取 Frida 无线管理总状态", + "operationId": "frida_status_api_v3_frida_status_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Frida Status Api V3 Frida Status Get" + } + } + } + } + } + } + }, + "/api/v3/frida/actions": { + "get": { + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "summary": "List Supported Actions", + "description": "列出所有支持的 Frida RPC 操作", + "operationId": "list_supported_actions_api_v3_frida_actions_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response List Supported Actions Api V3 Frida Actions Get" + } + } + } + } + } + } + }, + "/api/v3/wechat/channels/browse": { + "get": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Browse Channels", + "description": "浏览视频号", + "operationId": "browse_channels_api_v3_wechat_channels_browse_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 10, + "title": "Limit" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Browse Channels Api V3 Wechat Channels Browse Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/channels/like": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Like Channel Video", + "description": "视频号点赞", + "operationId": "like_channel_video_api_v3_wechat_channels_like_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ChannelVideoRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Like Channel Video Api V3 Wechat Channels Like Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/channels/comment": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Comment Channel Video", + "description": "视频号评论", + "operationId": "comment_channel_video_api_v3_wechat_channels_comment_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ChannelCommentRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Comment Channel Video Api V3 Wechat Channels Comment Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/channels/follow": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Follow Channel", + "description": "关注视频号", + "operationId": "follow_channel_api_v3_wechat_channels_follow_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ChannelFollowRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Follow Channel Api V3 Wechat Channels Follow Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/channels/unfollow": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Unfollow Channel", + "description": "取消关注视频号", + "operationId": "unfollow_channel_api_v3_wechat_channels_unfollow_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ChannelFollowRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Unfollow Channel Api V3 Wechat Channels Unfollow Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/channels/share": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Share Channel Video", + "description": "分享视频号视频", + "operationId": "share_channel_video_api_v3_wechat_channels_share_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ShareChannelRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Share Channel Video Api V3 Wechat Channels Share Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/mini-program/open": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Open Mini Program", + "description": "打开小程序", + "operationId": "open_mini_program_api_v3_wechat_mini_program_open_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/MiniProgramRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Open Mini Program Api V3 Wechat Mini Program Open Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/mini-program/recent": { + "get": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Get Recent Mini Programs", + "description": "获取最近使用的小程序", + "operationId": "get_recent_mini_programs_api_v3_wechat_mini_program_recent_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Recent Mini Programs Api V3 Wechat Mini Program Recent Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/mini-program/share": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Share Mini Program", + "description": "分享小程序", + "operationId": "share_mini_program_api_v3_wechat_mini_program_share_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ShareMiniProgramRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Share Mini Program Api V3 Wechat Mini Program Share Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/favorites": { + "get": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Get Favorites", + "description": "获取收藏列表", + "operationId": "get_favorites_api_v3_wechat_favorites_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 50, + "title": "Limit" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Favorites Api V3 Wechat Favorites Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/favorites/add": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Add Favorite", + "description": "添加收藏", + "operationId": "add_favorite_api_v3_wechat_favorites_add_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/FavoriteRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Add Favorite Api V3 Wechat Favorites Add Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/favorites/{local_id}": { + "delete": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Delete Favorite", + "description": "删除收藏", + "operationId": "delete_favorite_api_v3_wechat_favorites__local_id__delete", + "parameters": [ + { + "name": "local_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Local Id" + } + }, + { + "name": "device_id", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Delete Favorite Api V3 Wechat Favorites Local Id Delete" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/official-accounts": { + "get": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Get Official Accounts", + "description": "获取关注的公众号列表", + "operationId": "get_official_accounts_api_v3_wechat_official_accounts_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 100, + "title": "Limit" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Official Accounts Api V3 Wechat Official Accounts Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/official-accounts/follow": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Follow Official Account", + "description": "关注公众号", + "operationId": "follow_official_account_api_v3_wechat_official_accounts_follow_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OfficialAccountRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Follow Official Account Api V3 Wechat Official Accounts Follow Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/official-accounts/unfollow": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Unfollow Official Account", + "description": "取消关注公众号", + "operationId": "unfollow_official_account_api_v3_wechat_official_accounts_unfollow_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OfficialAccountRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Unfollow Official Account Api V3 Wechat Official Accounts Unfollow Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/official-accounts/{account_id}/articles": { + "get": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Get Official Account Articles", + "description": "获取公众号文章", + "operationId": "get_official_account_articles_api_v3_wechat_official_accounts__account_id__articles_get", + "parameters": [ + { + "name": "account_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Account Id" + } + }, + { + "name": "device_id", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "Device Id" + } + }, + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 10, + "title": "Limit" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Official Account Articles Api V3 Wechat Official Accounts Account Id Articles Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/security/unblock": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Unblock Self", + "description": "自助解封", + "operationId": "unblock_self_api_v3_wechat_security_unblock_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/WechatBaseRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Unblock Self Api V3 Wechat Security Unblock Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/security/change-password": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Change Password", + "description": "修改密码", + "operationId": "change_password_api_v3_wechat_security_change_password_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/PasswordRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Change Password Api V3 Wechat Security Change Password Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/security/bind-phone": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Bind Phone", + "description": "绑定手机号", + "operationId": "bind_phone_api_v3_wechat_security_bind_phone_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/PhoneRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Bind Phone Api V3 Wechat Security Bind Phone Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/security/unbind-phone": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Unbind Phone", + "description": "解绑手机号", + "operationId": "unbind_phone_api_v3_wechat_security_unbind_phone_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/WechatBaseRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Unbind Phone Api V3 Wechat Security Unbind Phone Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/security/login-devices": { + "get": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Get Login Devices", + "description": "获取登录设备列表", + "operationId": "get_login_devices_api_v3_wechat_security_login_devices_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Login Devices Api V3 Wechat Security Login Devices Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/security/login-device": { + "delete": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Remove Login Device", + "description": "移除登录设备", + "operationId": "remove_login_device_api_v3_wechat_security_login_device_delete", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/DeviceRemoveRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Remove Login Device Api V3 Wechat Security Login Device Delete" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/security/fingerprint": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Enable Fingerprint", + "description": "启用/禁用指纹", + "operationId": "enable_fingerprint_api_v3_wechat_security_fingerprint_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ToggleRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Enable Fingerprint Api V3 Wechat Security Fingerprint Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/security/account-protection": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Set Account Protection", + "description": "设置账号保护", + "operationId": "set_account_protection_api_v3_wechat_security_account_protection_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ToggleRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Set Account Protection Api V3 Wechat Security Account Protection Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/pay/red-packet": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Send Red Packet", + "description": "发红包", + "operationId": "send_red_packet_api_v3_wechat_pay_red_packet_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/RedPacketRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Send Red Packet Api V3 Wechat Pay Red Packet Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/pay/red-packet/receive": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Receive Red Packet", + "description": "收红包", + "operationId": "receive_red_packet_api_v3_wechat_pay_red_packet_receive_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ReceiveRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Receive Red Packet Api V3 Wechat Pay Red Packet Receive Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/pay/transfer": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Send Transfer", + "description": "转账", + "operationId": "send_transfer_api_v3_wechat_pay_transfer_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/TransferRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Send Transfer Api V3 Wechat Pay Transfer Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/pay/transfer/receive": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Receive Transfer", + "description": "收转账", + "operationId": "receive_transfer_api_v3_wechat_pay_transfer_receive_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ReceiveRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Receive Transfer Api V3 Wechat Pay Transfer Receive Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/pay/balance": { + "get": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Get Wallet Balance", + "description": "获取钱包余额", + "operationId": "get_wallet_balance_api_v3_wechat_pay_balance_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Wallet Balance Api V3 Wechat Pay Balance Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/pay/transactions": { + "get": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Get Transaction History", + "description": "获取交易记录", + "operationId": "get_transaction_history_api_v3_wechat_pay_transactions_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 20, + "title": "Limit" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Transaction History Api V3 Wechat Pay Transactions Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/float/add": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Add To Float", + "description": "添加到浮窗", + "operationId": "add_to_float_api_v3_wechat_float_add_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/FloatRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Add To Float Api V3 Wechat Float Add Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/float/remove": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Remove From Float", + "description": "从浮窗移除", + "operationId": "remove_from_float_api_v3_wechat_float_remove_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/FloatRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Remove From Float Api V3 Wechat Float Remove Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/emoji/send-custom": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Send Emoji Custom", + "description": "发送自定义表情", + "operationId": "send_emoji_custom_api_v3_wechat_emoji_send_custom_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/EmojiSendRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Send Emoji Custom Api V3 Wechat Emoji Send Custom Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/emoji/add-custom": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Add Custom Emoji", + "description": "添加自定义表情", + "operationId": "add_custom_emoji_api_v3_wechat_emoji_add_custom_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/EmojiAddRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Add Custom Emoji Api V3 Wechat Emoji Add Custom Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/profile": { + "get": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Get Profile", + "description": "获取个人资料", + "operationId": "get_profile_api_v3_wechat_profile_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Profile Api V3 Wechat Profile Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/account/status": { + "get": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Check Account Status", + "description": "检查账号状态", + "operationId": "check_account_status_api_v3_wechat_account_status_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Check Account Status Api V3 Wechat Account Status Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/profile/nickname": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Set Nickname", + "description": "设置昵称", + "operationId": "set_nickname_api_v3_wechat_profile_nickname_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ProfileSetRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Set Nickname Api V3 Wechat Profile Nickname Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/profile/signature": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Set Signature", + "description": "设置签名", + "operationId": "set_signature_api_v3_wechat_profile_signature_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ProfileSetRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Set Signature Api V3 Wechat Profile Signature Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/profile/avatar": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Set Avatar", + "description": "设置头像", + "operationId": "set_avatar_api_v3_wechat_profile_avatar_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ProfileSetRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Set Avatar Api V3 Wechat Profile Avatar Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/profile/sex": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Set Sex", + "description": "设置性别", + "operationId": "set_sex_api_v3_wechat_profile_sex_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ProfileSetRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Set Sex Api V3 Wechat Profile Sex Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/profile/region": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Set Region", + "description": "设置地区", + "operationId": "set_region_api_v3_wechat_profile_region_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ProfileSetRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Set Region Api V3 Wechat Profile Region Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/profile/status": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Set What Up", + "description": "设置状态", + "operationId": "set_what_up_api_v3_wechat_profile_status_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ProfileSetRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Set What Up Api V3 Wechat Profile Status Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/search": { + "get": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Global Search", + "description": "全局搜索", + "operationId": "global_search_api_v3_wechat_search_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + }, + { + "name": "keyword", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Keyword" + } + }, + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 30, + "title": "Limit" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Global Search Api V3 Wechat Search Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/settings/privacy": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Set Privacy", + "description": "设置隐私", + "operationId": "set_privacy_api_v3_wechat_settings_privacy_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/PrivacyRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Set Privacy Api V3 Wechat Settings Privacy Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/settings/notification": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Set Notification", + "description": "设置通知", + "operationId": "set_notification_api_v3_wechat_settings_notification_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/NotificationRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Set Notification Api V3 Wechat Settings Notification Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/settings/clear-history": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Clear Chat History", + "description": "清除聊天记录", + "operationId": "clear_chat_history_api_v3_wechat_settings_clear_history_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/WxidRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Clear Chat History Api V3 Wechat Settings Clear History Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/settings/chat-background": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Set Chat Background", + "description": "设置聊天背景", + "operationId": "set_chat_background_api_v3_wechat_settings_chat_background_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ChatBgRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Set Chat Background Api V3 Wechat Settings Chat Background Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/settings/dnd": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Set Do Not Disturb", + "description": "设置免打扰", + "operationId": "set_do_not_disturb_api_v3_wechat_settings_dnd_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/DndRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Set Do Not Disturb Api V3 Wechat Settings Dnd Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/settings/pin-chat": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Pin Chat", + "description": "置顶聊天", + "operationId": "pin_chat_api_v3_wechat_settings_pin_chat_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/PinChatRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Pin Chat Api V3 Wechat Settings Pin Chat Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/qr/scan": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Scan Qr Code", + "description": "扫描二维码", + "operationId": "scan_qr_code_api_v3_wechat_qr_scan_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/QrScanRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Scan Qr Code Api V3 Wechat Qr Scan Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/qr/my": { + "get": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Generate My Qr Code", + "description": "生成我的二维码", + "operationId": "generate_my_qr_code_api_v3_wechat_qr_my_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Generate My Qr Code Api V3 Wechat Qr My Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/qr/group/{group_id}": { + "get": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Generate Group Qr Code", + "description": "生成群二维码", + "operationId": "generate_group_qr_code_api_v3_wechat_qr_group__group_id__get", + "parameters": [ + { + "name": "group_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Group Id" + } + }, + { + "name": "device_id", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Generate Group Qr Code Api V3 Wechat Qr Group Group Id Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/device-info": { + "get": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Get Device Info", + "description": "获取设备信息", + "operationId": "get_device_info_api_v3_wechat_device_info_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Device Info Api V3 Wechat Device Info Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/storage-info": { + "get": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Get Storage Info", + "description": "获取存储信息", + "operationId": "get_storage_info_api_v3_wechat_storage_info_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Storage Info Api V3 Wechat Storage Info Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/network-info": { + "get": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Get Network Info", + "description": "获取网络信息", + "operationId": "get_network_info_api_v3_wechat_network_info_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Network Info Api V3 Wechat Network Info Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/tag/set-contact": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Set Contact Label", + "description": "设置联系人标签", + "operationId": "set_contact_label_api_v3_wechat_tag_set_contact_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/LabelContactRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Set Contact Label Api V3 Wechat Tag Set Contact Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/tag/contacts/{label_id}": { + "get": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Get Contacts By Label", + "description": "按标签获取联系人", + "operationId": "get_contacts_by_label_api_v3_wechat_tag_contacts__label_id__get", + "parameters": [ + { + "name": "label_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Label Id" + } + }, + { + "name": "device_id", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Contacts By Label Api V3 Wechat Tag Contacts Label Id Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/hook/status": { + "get": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Get Hook Status", + "description": "获取 Hook 状态", + "operationId": "get_hook_status_api_v3_wechat_hook_status_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Hook Status Api V3 Wechat Hook Status Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/hook/process-info": { + "get": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Get Process Info", + "description": "获取微信进程信息", + "operationId": "get_process_info_api_v3_wechat_hook_process_info_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Process Info Api V3 Wechat Hook Process Info Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/hook/wechat-version": { + "get": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Get Wechat Version", + "description": "获取微信版本", + "operationId": "get_wechat_version_api_v3_wechat_hook_wechat_version_get", + "parameters": [ + { + "name": "device_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "title": "Device Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true, + "title": "Response Get Wechat Version Api V3 Wechat Hook Wechat Version Get" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/execute": { + "post": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "Unified Execute", + "description": "统一执行入口 — 支持所有 112 个微信操作\n\n通过 action 名直接调用对应的 Frida RPC 方法。\n通道自动选择:Hook > WebSocket Agent > UI 自动化", + "operationId": "unified_execute_api_v3_wechat_execute_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/UnifiedExecuteRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response Unified Execute Api V3 Wechat Execute Post" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/wechat/actions": { + "get": { + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "summary": "List All Actions", + "description": "列出所有支持的微信操作", + "operationId": "list_all_actions_api_v3_wechat_actions_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "additionalProperties": true, + "type": "object", + "title": "Response List All Actions Api V3 Wechat Actions Get" + } + } + } + } + } + } + }, + "/health": { + "get": { + "summary": "Health Check", + "description": "健康检查", + "operationId": "health_check_health_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/ready": { + "get": { + "summary": "Ready", + "description": "就绪探针(部署/负载均衡用):进程已启动且可接收流量", + "operationId": "ready_ready_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/": { + "get": { + "summary": "Root", + "description": "根路由 → 聚合总控台", + "operationId": "root__get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/hub": { + "get": { + "summary": "Hub Page", + "description": "统一聚合总控台", + "operationId": "hub_page_hub_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/control": { + "get": { + "summary": "Control Page", + "description": "兼容旧入口,统一回到工作台", + "operationId": "control_page_control_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/voice": { + "get": { + "summary": "Voice Control Page", + "description": "语音控制页面", + "operationId": "voice_control_page_voice_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/wechat": { + "get": { + "summary": "Wechat Control Page", + "description": "微信全链路控制面板(96个action / 29个功能模块)", + "operationId": "wechat_control_page_wechat_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/pages/{page_key}": { + "get": { + "summary": "Docs Page", + "description": "聚合页内嵌的项目文档页面", + "operationId": "docs_page_pages__page_key__get", + "parameters": [ + { + "name": "page_key", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Page Key" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/workbench/overview": { + "get": { + "summary": "Workbench Overview", + "description": "工作台统一概览 DTO,供工作台前端与存客宝页面共用。", + "operationId": "workbench_overview_api_v3_workbench_overview_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/api/v3/workbench/docs": { + "get": { + "summary": "Workbench Docs", + "description": "工作台文档清单。", + "operationId": "workbench_docs_api_v3_workbench_docs_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/api/v3/workbench/docs/{doc_id}": { + "get": { + "summary": "Workbench Doc Detail", + "description": "读取工作台文档正文并返回渲染后的 HTML。", + "operationId": "workbench_doc_detail_api_v3_workbench_docs__doc_id__get", + "parameters": [ + { + "name": "doc_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "title": "Doc Id" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + } + } + }, + "/api/v3/agent/download": { + "get": { + "summary": "Download Agent", + "description": "下载设备端 Agent 打包文件(agent.tar.gz)\n\n设备端 install.sh 会调用此接口自动下载代码。\n如果 dist/agent.tar.gz 不存在,自动运行 package.sh 打包。", + "operationId": "download_agent_api_v3_agent_download_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + }, + "/install.sh": { + "get": { + "summary": "Serve Install Script", + "description": "提供 Termux 一键安装脚本\n\n用法: curl -sL http://服务器IP:8899/install.sh | bash -s -- --server ws://服务器IP:8899/ws/device", + "operationId": "serve_install_script_install_sh_get", + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": {} + } + } + } + } + } + } + }, + "components": { + "schemas": { + "AIChatRequest": { + "properties": { + "message": { + "type": "string", + "title": "Message" + }, + "device_id": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Device Id" + } + }, + "type": "object", + "required": [ + "message" + ], + "title": "AIChatRequest" + }, + "AITaskRequest": { + "properties": { + "instruction": { + "type": "string", + "title": "Instruction" + }, + "priority": { + "type": "integer", + "title": "Priority", + "default": 5 + } + }, + "type": "object", + "required": [ + "instruction" + ], + "title": "AITaskRequest", + "description": "AI 任务推送请求" + }, + "AcceptFriendRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "user_id": { + "type": "string", + "title": "User Id" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "user_id" + ], + "title": "AcceptFriendRequest", + "description": "通过好友请求" + }, + "AddFavoriteRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "content_desc": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Content Desc" + } + }, + "type": "object", + "required": [ + "device_id", + "platform" + ], + "title": "AddFavoriteRequest" + }, + "AddFriendRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "user_id": { + "type": "string", + "title": "User Id" + }, + "message": { + "type": "string", + "title": "Message", + "default": "" + }, + "source": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Source" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "user_id" + ], + "title": "AddFriendRequest", + "description": "添加好友请求" + }, + "AddTagRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "user_id": { + "type": "string", + "title": "User Id" + }, + "tags": { + "items": { + "type": "string" + }, + "type": "array", + "title": "Tags" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "user_id", + "tags" + ], + "title": "AddTagRequest", + "description": "添加标签请求" + }, + "AppRequest": { + "properties": { + "package": { + "type": "string", + "title": "Package" + } + }, + "type": "object", + "required": [ + "package" + ], + "title": "AppRequest" + }, + "AutoRegisterRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "nickname": { + "type": "string", + "title": "Nickname", + "default": "卡若AI" + }, + "password": { + "type": "string", + "title": "Password", + "default": "" + }, + "test_msg_to": { + "type": "string", + "title": "Test Msg To", + "default": "" + }, + "test_msg_content": { + "type": "string", + "title": "Test Msg Content", + "default": "你好,我是卡若AI工作手机" + } + }, + "type": "object", + "required": [ + "device_id" + ], + "title": "AutoRegisterRequest", + "description": "自动注册请求" + }, + "BatchAddFriendRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "user_ids": { + "items": { + "type": "string" + }, + "type": "array", + "title": "User Ids" + }, + "message": { + "type": "string", + "title": "Message", + "default": "" + }, + "interval": { + "type": "number", + "title": "Interval", + "default": 5.0 + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "user_ids" + ], + "title": "BatchAddFriendRequest", + "description": "批量添加好友请求" + }, + "BatchCommandRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "commands": { + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array", + "title": "Commands" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 60 + } + }, + "type": "object", + "required": [ + "device_id", + "commands" + ], + "title": "BatchCommandRequest", + "description": "批量指令请求" + }, + "BatchContactRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id", + "description": "设备ID" + }, + "source": { + "type": "string", + "title": "Source", + "description": "来源", + "default": "微信通讯录" + }, + "contacts": { + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array", + "title": "Contacts", + "description": "联系人列表" + } + }, + "type": "object", + "required": [ + "device_id", + "contacts" + ], + "title": "BatchContactRequest", + "description": "批量联系人上报请求" + }, + "BatchSendMessageRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "to_ids": { + "items": { + "type": "string" + }, + "type": "array", + "title": "To Ids" + }, + "content": { + "type": "string", + "title": "Content" + }, + "msg_type": { + "$ref": "#/components/schemas/MessageType", + "default": "text" + }, + "media_url": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Media Url" + }, + "interval": { + "type": "number", + "title": "Interval", + "default": 2.0 + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "to_ids", + "content" + ], + "title": "BatchSendMessageRequest", + "description": "批量发送消息请求" + }, + "Body_upload_script_api_v3_scripts_post": { + "properties": { + "file": { + "type": "string", + "format": "binary", + "title": "File" + } + }, + "type": "object", + "required": [ + "file" + ], + "title": "Body_upload_script_api_v3_scripts_post" + }, + "CKBConfigRequest": { + "properties": { + "api_key": { + "type": "string", + "title": "Api Key", + "description": "存客宝 API Key" + }, + "base_url": { + "type": "string", + "title": "Base Url", + "description": "存客宝接口地址", + "default": "https://ckbapi.quwanzhi.com/v1/api/scenarios" + }, + "timeout": { + "type": "integer", + "maximum": 60.0, + "minimum": 1.0, + "title": "Timeout", + "description": "请求超时秒数", + "default": 10 + }, + "max_retries": { + "type": "integer", + "maximum": 10.0, + "minimum": 1.0, + "title": "Max Retries", + "description": "最大重试次数", + "default": 3 + }, + "rate_limit_per_minute": { + "type": "integer", + "maximum": 600.0, + "minimum": 1.0, + "title": "Rate Limit Per Minute", + "description": "每分钟最大请求数", + "default": 60 + }, + "enabled": { + "type": "boolean", + "title": "Enabled", + "description": "是否启用", + "default": true + } + }, + "type": "object", + "required": [ + "api_key" + ], + "title": "CKBConfigRequest", + "description": "存客宝配置请求" + }, + "ChangePasswordRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "old_pwd": { + "type": "string", + "title": "Old Pwd" + }, + "new_pwd": { + "type": "string", + "title": "New Pwd" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "old_pwd", + "new_pwd" + ], + "title": "ChangePasswordRequest" + }, + "ChannelCommentRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "video_id": { + "type": "string", + "title": "Video Id" + }, + "comment": { + "type": "string", + "title": "Comment" + } + }, + "type": "object", + "required": [ + "device_id", + "video_id", + "comment" + ], + "title": "ChannelCommentRequest" + }, + "ChannelFollowRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "channel_id": { + "type": "string", + "title": "Channel Id" + } + }, + "type": "object", + "required": [ + "device_id", + "channel_id" + ], + "title": "ChannelFollowRequest" + }, + "ChannelVideoRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "video_id": { + "type": "string", + "title": "Video Id" + } + }, + "type": "object", + "required": [ + "device_id", + "video_id" + ], + "title": "ChannelVideoRequest" + }, + "ChatBgRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "wxid": { + "type": "string", + "title": "Wxid" + }, + "image_path": { + "type": "string", + "title": "Image Path", + "default": "" + } + }, + "type": "object", + "required": [ + "device_id", + "wxid" + ], + "title": "ChatBgRequest" + }, + "ChatMessage": { + "properties": { + "role": { + "type": "string", + "title": "Role", + "default": "user" + }, + "content": { + "type": "string", + "title": "Content" + } + }, + "type": "object", + "required": [ + "content" + ], + "title": "ChatMessage" + }, + "ChatRequest": { + "properties": { + "model": { + "type": "string", + "title": "Model", + "default": "workphone-agent" + }, + "messages": { + "items": { + "$ref": "#/components/schemas/ChatMessage" + }, + "type": "array", + "title": "Messages" + }, + "device_id": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Device Id" + }, + "stream": { + "type": "boolean", + "title": "Stream", + "default": false + }, + "temperature": { + "type": "number", + "title": "Temperature", + "default": 0.7 + } + }, + "type": "object", + "required": [ + "messages" + ], + "title": "ChatRequest" + }, + "ChatSettingRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "user_id": { + "type": "string", + "title": "User Id" + }, + "enable": { + "type": "boolean", + "title": "Enable", + "default": true + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "user_id" + ], + "title": "ChatSettingRequest" + }, + "CheckLoginStateRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + } + }, + "type": "object", + "required": [ + "device_id" + ], + "title": "CheckLoginStateRequest", + "description": "检查登录状态请求" + }, + "ClickRequest": { + "properties": { + "x": { + "type": "integer", + "title": "X" + }, + "y": { + "type": "integer", + "title": "Y" + } + }, + "type": "object", + "required": [ + "x", + "y" + ], + "title": "ClickRequest" + }, + "ClickTextRequest": { + "properties": { + "text": { + "type": "string", + "title": "Text" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 10 + } + }, + "type": "object", + "required": [ + "text" + ], + "title": "ClickTextRequest", + "description": "点击文字请求" + }, + "CommandRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "action": { + "type": "string", + "title": "Action" + }, + "params": { + "additionalProperties": true, + "type": "object", + "title": "Params" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + } + }, + "type": "object", + "required": [ + "device_id", + "action" + ], + "title": "CommandRequest", + "description": "指令执行请求" + }, + "CommentMomentsRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "user_id": { + "type": "string", + "title": "User Id" + }, + "post_index": { + "type": "integer", + "title": "Post Index", + "default": 0 + }, + "comment": { + "type": "string", + "title": "Comment" + }, + "reply_to": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Reply To" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "user_id", + "comment" + ], + "title": "CommentMomentsRequest", + "description": "评论朋友圈请求" + }, + "CreateGroupRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "group_name": { + "type": "string", + "title": "Group Name" + }, + "member_ids": { + "items": { + "type": "string" + }, + "type": "array", + "title": "Member Ids" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "group_name", + "member_ids" + ], + "title": "CreateGroupRequest", + "description": "创建群聊请求" + }, + "CreateTagRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "tag_name": { + "type": "string", + "title": "Tag Name" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "tag_name" + ], + "title": "CreateTagRequest", + "description": "创建标签请求" + }, + "DeleteFriendRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "user_id": { + "type": "string", + "title": "User Id" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "user_id" + ], + "title": "DeleteFriendRequest", + "description": "删除好友请求" + }, + "DeleteTagRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "tag_name": { + "type": "string", + "title": "Tag Name" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "tag_name" + ], + "title": "DeleteTagRequest", + "description": "删除标签请求" + }, + "DeployScriptRequest": { + "properties": { + "mode": { + "type": "string", + "title": "Mode", + "default": "auto" + }, + "server_url": { + "type": "string", + "title": "Server Url", + "default": "" + }, + "port": { + "type": "integer", + "title": "Port", + "default": 0 + }, + "arch": { + "type": "string", + "title": "Arch", + "default": "arm64" + } + }, + "type": "object", + "title": "DeployScriptRequest", + "description": "部署脚本生成请求" + }, + "DeviceConnectRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "force": { + "type": "boolean", + "title": "Force", + "default": false + } + }, + "type": "object", + "required": [ + "device_id" + ], + "title": "DeviceConnectRequest", + "description": "设备连接请求" + }, + "DeviceGroupRequest": { + "properties": { + "group_name": { + "type": "string", + "title": "Group Name" + }, + "device_ids": { + "items": { + "type": "string" + }, + "type": "array", + "title": "Device Ids" + } + }, + "type": "object", + "required": [ + "group_name", + "device_ids" + ], + "title": "DeviceGroupRequest" + }, + "DeviceRegisterRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "ip": { + "type": "string", + "title": "Ip" + }, + "frida_port": { + "type": "integer", + "title": "Frida Port", + "default": 27042 + }, + "mode": { + "type": "string", + "title": "Mode", + "default": "auto" + }, + "android_version": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Android Version" + }, + "device_model": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Device Model" + }, + "frida_version": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Frida Version" + }, + "wechat_version": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Wechat Version" + } + }, + "type": "object", + "required": [ + "device_id", + "ip" + ], + "title": "DeviceRegisterRequest", + "description": "设备注册请求" + }, + "DeviceRemoveRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "target_device_id": { + "type": "string", + "title": "Target Device Id" + } + }, + "type": "object", + "required": [ + "device_id", + "target_device_id" + ], + "title": "DeviceRemoveRequest" + }, + "DiscoverRequest": { + "properties": { + "subnet": { + "type": "string", + "title": "Subnet", + "default": "" + }, + "port": { + "type": "integer", + "title": "Port", + "default": 27042 + }, + "timeout": { + "type": "number", + "title": "Timeout", + "default": 2.0 + } + }, + "type": "object", + "title": "DiscoverRequest", + "description": "设备发现请求" + }, + "DndRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "wxid": { + "type": "string", + "title": "Wxid" + }, + "enable": { + "type": "boolean", + "title": "Enable", + "default": true + } + }, + "type": "object", + "required": [ + "device_id", + "wxid" + ], + "title": "DndRequest" + }, + "EmojiAddRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "image_path": { + "type": "string", + "title": "Image Path" + } + }, + "type": "object", + "required": [ + "device_id", + "image_path" + ], + "title": "EmojiAddRequest" + }, + "EmojiSendRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "to_id": { + "type": "string", + "title": "To Id" + }, + "emoji_md5": { + "type": "string", + "title": "Emoji Md5" + } + }, + "type": "object", + "required": [ + "device_id", + "to_id", + "emoji_md5" + ], + "title": "EmojiSendRequest" + }, + "ExecuteCommand": { + "properties": { + "action": { + "type": "string", + "title": "Action" + }, + "params": { + "anyOf": [ + { + "additionalProperties": true, + "type": "object" + }, + { + "type": "null" + } + ], + "title": "Params", + "default": {} + } + }, + "type": "object", + "required": [ + "action" + ], + "title": "ExecuteCommand", + "description": "执行命令请求" + }, + "ExecuteTaskRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "task": { + "type": "string", + "title": "Task" + }, + "llm_provider": { + "type": "string", + "title": "Llm Provider", + "default": "deepseek" + }, + "max_steps": { + "type": "integer", + "title": "Max Steps", + "default": 30 + } + }, + "type": "object", + "required": [ + "device_id", + "task" + ], + "title": "ExecuteTaskRequest", + "description": "执行任务请求" + }, + "FavoriteRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "msg_svr_id": { + "type": "string", + "title": "Msg Svr Id", + "default": "" + }, + "local_id": { + "type": "string", + "title": "Local Id", + "default": "" + }, + "type": { + "type": "string", + "title": "Type", + "default": "message" + } + }, + "type": "object", + "required": [ + "device_id" + ], + "title": "FavoriteRequest" + }, + "FleetCommandRequest": { + "properties": { + "device_ids": { + "anyOf": [ + { + "items": { + "type": "string" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Device Ids" + }, + "command": { + "type": "string", + "title": "Command" + }, + "params": { + "additionalProperties": true, + "type": "object", + "title": "Params", + "default": {} + } + }, + "type": "object", + "required": [ + "command" + ], + "title": "FleetCommandRequest" + }, + "FloatRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "wxid": { + "type": "string", + "title": "Wxid" + } + }, + "type": "object", + "required": [ + "device_id", + "wxid" + ], + "title": "FloatRequest" + }, + "ForwardMessageRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "to_id": { + "type": "string", + "title": "To Id" + }, + "content": { + "type": "string", + "title": "Content" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "to_id", + "content" + ], + "title": "ForwardMessageRequest" + }, + "FriendAddEventRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id", + "description": "设备ID" + }, + "wechat_id": { + "type": "string", + "title": "Wechat Id", + "description": "微信号" + }, + "nickname": { + "type": "string", + "title": "Nickname", + "description": "昵称", + "default": "" + }, + "avatar": { + "type": "string", + "title": "Avatar", + "description": "头像URL", + "default": "" + }, + "source": { + "type": "string", + "title": "Source", + "description": "来源", + "default": "微信添加" + } + }, + "type": "object", + "required": [ + "device_id", + "wechat_id" + ], + "title": "FriendAddEventRequest", + "description": "新好友添加事件请求(来自 Frida Hook)" + }, + "GetMessagesRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "conversation_id": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Conversation Id" + }, + "limit": { + "type": "integer", + "title": "Limit", + "default": 20 + }, + "since_time": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "null" + } + ], + "title": "Since Time" + } + }, + "type": "object", + "required": [ + "device_id", + "platform" + ], + "title": "GetMessagesRequest", + "description": "获取消息请求" + }, + "GetMomentsRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "user_id": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "User Id" + }, + "limit": { + "type": "integer", + "title": "Limit", + "default": 10 + } + }, + "type": "object", + "required": [ + "device_id", + "platform" + ], + "title": "GetMomentsRequest", + "description": "获取朋友圈请求" + }, + "GetSimPhoneRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + } + }, + "type": "object", + "required": [ + "device_id" + ], + "title": "GetSimPhoneRequest", + "description": "获取 SIM 卡手机号请求" + }, + "GetUsersByTagRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "tag_name": { + "type": "string", + "title": "Tag Name" + }, + "limit": { + "type": "integer", + "title": "Limit", + "default": 100 + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "tag_name" + ], + "title": "GetUsersByTagRequest", + "description": "根据标签获取用户请求" + }, + "GroupChangeEventRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id", + "description": "设备ID" + }, + "group_id": { + "type": "string", + "title": "Group Id", + "description": "群ID" + }, + "group_name": { + "type": "string", + "title": "Group Name", + "description": "群名称", + "default": "" + }, + "event_type": { + "type": "string", + "title": "Event Type", + "description": "事件类型: member_join/member_leave/group_create" + }, + "member_wechat_id": { + "type": "string", + "title": "Member Wechat Id", + "description": "成员微信号", + "default": "" + }, + "member_nickname": { + "type": "string", + "title": "Member Nickname", + "description": "成员昵称", + "default": "" + } + }, + "type": "object", + "required": [ + "device_id", + "group_id", + "event_type" + ], + "title": "GroupChangeEventRequest", + "description": "群变动事件请求(来自 Frida Hook)" + }, + "GroupMessageRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "group_id": { + "type": "string", + "title": "Group Id" + }, + "content": { + "type": "string", + "title": "Content" + }, + "msg_type": { + "$ref": "#/components/schemas/MessageType", + "default": "text" + }, + "media_url": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Media Url" + }, + "at_all": { + "type": "boolean", + "title": "At All", + "default": false + }, + "at_list": { + "anyOf": [ + { + "items": { + "type": "string" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "At List" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "group_id", + "content" + ], + "title": "GroupMessageRequest", + "description": "群发消息请求" + }, + "HTTPValidationError": { + "properties": { + "detail": { + "items": { + "$ref": "#/components/schemas/ValidationError" + }, + "type": "array", + "title": "Detail" + } + }, + "type": "object", + "title": "HTTPValidationError" + }, + "HeartbeatBody": { + "properties": { + "node_id": { + "type": "string", + "title": "Node Id" + }, + "token": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Token" + }, + "device_count": { + "type": "integer", + "title": "Device Count", + "default": 0 + }, + "version": { + "type": "string", + "title": "Version", + "default": "" + } + }, + "type": "object", + "required": [ + "node_id" + ], + "title": "HeartbeatBody" + }, + "HeartbeatConfigRequest": { + "properties": { + "heartbeat_interval_seconds": { + "type": "integer", + "title": "Heartbeat Interval Seconds" + } + }, + "type": "object", + "required": [ + "heartbeat_interval_seconds" + ], + "title": "HeartbeatConfigRequest", + "description": "心跳配置请求" + }, + "HookExecuteRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform", + "default": "wechat" + }, + "action": { + "type": "string", + "title": "Action", + "description": "操作名:send_message / get_contacts / get_profile / ... 共 107 个" + }, + "params": { + "additionalProperties": true, + "type": "object", + "title": "Params", + "description": "action 所需参数(键值对)" + }, + "hook_only": { + "type": "boolean", + "title": "Hook Only", + "description": "为 True 时仅走 Frida Hook,失败不降级 u2/ADB(纯 HWK 联调)", + "default": false + } + }, + "type": "object", + "required": [ + "device_id", + "action" + ], + "title": "HookExecuteRequest", + "description": "Hawk Hook 格式 — 单端点执行任意操作,任何应用可直连" + }, + "InputRequest": { + "properties": { + "text": { + "type": "string", + "title": "Text" + }, + "clear": { + "type": "boolean", + "title": "Clear", + "default": true + } + }, + "type": "object", + "required": [ + "text" + ], + "title": "InputRequest", + "description": "输入请求" + }, + "InviteToGroupRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "group_id": { + "type": "string", + "title": "Group Id" + }, + "member_ids": { + "items": { + "type": "string" + }, + "type": "array", + "title": "Member Ids" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "group_id", + "member_ids" + ], + "title": "InviteToGroupRequest", + "description": "邀请入群请求" + }, + "KeyRequest": { + "properties": { + "key": { + "type": "string", + "title": "Key" + } + }, + "type": "object", + "required": [ + "key" + ], + "title": "KeyRequest" + }, + "LabelContactRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "wxid": { + "type": "string", + "title": "Wxid" + }, + "label_ids": { + "items": { + "type": "string" + }, + "type": "array", + "title": "Label Ids" + } + }, + "type": "object", + "required": [ + "device_id", + "wxid", + "label_ids" + ], + "title": "LabelContactRequest" + }, + "LeadReportRequest": { + "properties": { + "phone": { + "type": "string", + "title": "Phone", + "description": "手机号", + "default": "" + }, + "name": { + "type": "string", + "title": "Name", + "description": "姓名", + "default": "" + }, + "source": { + "type": "string", + "title": "Source", + "description": "来源渠道", + "default": "微信" + }, + "wechat_id": { + "type": "string", + "title": "Wechat Id", + "description": "微信号", + "default": "" + }, + "wechat_nickname": { + "type": "string", + "title": "Wechat Nickname", + "description": "微信昵称", + "default": "" + }, + "wechat_remark": { + "type": "string", + "title": "Wechat Remark", + "description": "备注名", + "default": "" + }, + "tags": { + "items": { + "type": "string" + }, + "type": "array", + "title": "Tags", + "description": "标签列表" + }, + "group_name": { + "type": "string", + "title": "Group Name", + "description": "所在群名", + "default": "" + }, + "device_id": { + "type": "string", + "title": "Device Id", + "description": "设备ID", + "default": "" + }, + "extra": { + "additionalProperties": true, + "type": "object", + "title": "Extra", + "description": "扩展字段" + } + }, + "type": "object", + "title": "LeadReportRequest", + "description": "线索上报请求" + }, + "LikeMomentsRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "user_id": { + "type": "string", + "title": "User Id" + }, + "post_index": { + "type": "integer", + "title": "Post Index", + "default": 0 + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "user_id" + ], + "title": "LikeMomentsRequest", + "description": "点赞朋友圈请求" + }, + "MassSendRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "content": { + "type": "string", + "title": "Content" + }, + "user_ids": { + "items": { + "type": "string" + }, + "type": "array", + "title": "User Ids" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "content", + "user_ids" + ], + "title": "MassSendRequest" + }, + "MessageType": { + "type": "string", + "enum": [ + "text", + "image", + "video", + "voice", + "file", + "link", + "mini_program" + ], + "title": "MessageType", + "description": "消息类型" + }, + "MiniProgramRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "app_id": { + "type": "string", + "title": "App Id" + }, + "path": { + "type": "string", + "title": "Path", + "default": "" + } + }, + "type": "object", + "required": [ + "device_id", + "app_id" + ], + "title": "MiniProgramRequest" + }, + "ModuleUpsertRequest": { + "properties": { + "module_id": { + "type": "string", + "title": "Module Id" + }, + "name": { + "type": "string", + "title": "Name" + }, + "version": { + "type": "string", + "title": "Version", + "default": "1.0.0" + }, + "description": { + "type": "string", + "title": "Description", + "default": "" + }, + "scopes": { + "items": { + "type": "string" + }, + "type": "array", + "title": "Scopes" + }, + "capabilities": { + "items": { + "type": "string" + }, + "type": "array", + "title": "Capabilities" + }, + "min_frida_version": { + "type": "string", + "title": "Min Frida Version", + "default": "16.0.0" + }, + "script_content": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Script Content" + }, + "enabled": { + "type": "boolean", + "title": "Enabled", + "default": true + } + }, + "type": "object", + "required": [ + "module_id", + "name" + ], + "title": "ModuleUpsertRequest" + }, + "NotificationRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "type": { + "type": "string", + "title": "Type", + "default": "all" + }, + "enable": { + "type": "boolean", + "title": "Enable", + "default": true + } + }, + "type": "object", + "required": [ + "device_id" + ], + "title": "NotificationRequest" + }, + "OfficialAccountRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "account_id": { + "type": "string", + "title": "Account Id" + } + }, + "type": "object", + "required": [ + "device_id", + "account_id" + ], + "title": "OfficialAccountRequest" + }, + "PasswordRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "old_password": { + "type": "string", + "title": "Old Password" + }, + "new_password": { + "type": "string", + "title": "New Password" + } + }, + "type": "object", + "required": [ + "device_id", + "old_password", + "new_password" + ], + "title": "PasswordRequest" + }, + "PhoneRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "phone": { + "type": "string", + "title": "Phone" + } + }, + "type": "object", + "required": [ + "device_id", + "phone" + ], + "title": "PhoneRequest" + }, + "PinChatRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "wxid": { + "type": "string", + "title": "Wxid" + }, + "pin": { + "type": "boolean", + "title": "Pin", + "default": true + } + }, + "type": "object", + "required": [ + "device_id", + "wxid" + ], + "title": "PinChatRequest" + }, + "Platform": { + "type": "string", + "enum": [ + "wechat", + "douyin", + "xhs", + "xianyu", + "soul" + ], + "title": "Platform", + "description": "支持的平台" + }, + "PostMomentsRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "content": { + "type": "string", + "title": "Content" + }, + "images": { + "anyOf": [ + { + "items": { + "type": "string" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Images" + }, + "video_url": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Video Url" + }, + "location": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Location" + }, + "visible_list": { + "anyOf": [ + { + "items": { + "type": "string" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Visible List" + }, + "invisible_list": { + "anyOf": [ + { + "items": { + "type": "string" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Invisible List" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "content" + ], + "title": "PostMomentsRequest", + "description": "发布朋友圈请求" + }, + "PrivacyRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "setting": { + "type": "string", + "title": "Setting" + }, + "value": { + "type": "boolean", + "title": "Value", + "default": true + } + }, + "type": "object", + "required": [ + "device_id", + "setting" + ], + "title": "PrivacyRequest" + }, + "ProfileSetRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "value": { + "type": "string", + "title": "Value" + } + }, + "type": "object", + "required": [ + "device_id", + "value" + ], + "title": "ProfileSetRequest" + }, + "ProjectBindConfig": { + "properties": { + "project_id": { + "type": "string", + "title": "Project Id" + }, + "project_name": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Project Name", + "default": "" + }, + "server": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Server", + "default": "ws://sdk.quwanzhi.com:8899/ws/device" + }, + "pwa": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Pwa", + "default": "" + } + }, + "type": "object", + "required": [ + "project_id" + ], + "title": "ProjectBindConfig", + "description": "项目绑定配置" + }, + "QrScanRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "image_path": { + "type": "string", + "title": "Image Path", + "default": "" + } + }, + "type": "object", + "required": [ + "device_id" + ], + "title": "QrScanRequest" + }, + "RecallMessageRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform", + "default": "wechat" + } + }, + "type": "object", + "required": [ + "device_id" + ], + "title": "RecallMessageRequest" + }, + "ReceiveRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "msg_svr_id": { + "type": "string", + "title": "Msg Svr Id" + } + }, + "type": "object", + "required": [ + "device_id", + "msg_svr_id" + ], + "title": "ReceiveRequest" + }, + "RecordOperation": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "app": { + "type": "string", + "title": "App" + }, + "action": { + "type": "string", + "title": "Action" + }, + "params": { + "additionalProperties": true, + "type": "object", + "title": "Params" + }, + "result": { + "additionalProperties": true, + "type": "object", + "title": "Result" + }, + "duration_ms": { + "type": "integer", + "title": "Duration Ms" + } + }, + "type": "object", + "required": [ + "device_id", + "app", + "action", + "params", + "result", + "duration_ms" + ], + "title": "RecordOperation" + }, + "RedPacketRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "to_id": { + "type": "string", + "title": "To Id" + }, + "amount": { + "type": "string", + "title": "Amount" + }, + "message": { + "type": "string", + "title": "Message", + "default": "恭喜发财" + } + }, + "type": "object", + "required": [ + "device_id", + "to_id", + "amount" + ], + "title": "RedPacketRequest" + }, + "RegisterNodeBody": { + "properties": { + "node_id": { + "type": "string", + "title": "Node Id", + "description": "对端 SDK 唯一 ID" + }, + "base_url": { + "type": "string", + "title": "Base Url", + "description": "对端 HTTP Base,如 http://192.168.1.20:8899" + }, + "label": { + "type": "string", + "title": "Label", + "default": "" + }, + "token": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Token" + }, + "version": { + "type": "string", + "title": "Version", + "default": "" + } + }, + "type": "object", + "required": [ + "node_id", + "base_url" + ], + "title": "RegisterNodeBody" + }, + "ReloadDeviceModulesRequest": { + "properties": { + "module_ids": { + "items": { + "type": "string" + }, + "type": "array", + "title": "Module Ids" + }, + "force": { + "type": "boolean", + "title": "Force", + "default": false + } + }, + "type": "object", + "required": [ + "module_ids" + ], + "title": "ReloadDeviceModulesRequest" + }, + "RemoveFromGroupRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "group_id": { + "type": "string", + "title": "Group Id" + }, + "member_ids": { + "items": { + "type": "string" + }, + "type": "array", + "title": "Member Ids" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "group_id", + "member_ids" + ], + "title": "RemoveFromGroupRequest", + "description": "移出群聊请求" + }, + "RemoveTagRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "user_id": { + "type": "string", + "title": "User Id" + }, + "tags": { + "items": { + "type": "string" + }, + "type": "array", + "title": "Tags" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "user_id", + "tags" + ], + "title": "RemoveTagRequest", + "description": "移除标签请求" + }, + "ReplyCommentRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "video_id": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Video Id" + }, + "comment_id": { + "type": "string", + "title": "Comment Id" + }, + "content": { + "type": "string", + "title": "Content" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "comment_id", + "content" + ], + "title": "ReplyCommentRequest", + "description": "回复评论请求(抖音/小红书等)" + }, + "ScopeUpdateRequest": { + "properties": { + "scopes": { + "items": { + "type": "string" + }, + "type": "array", + "title": "Scopes" + } + }, + "type": "object", + "required": [ + "scopes" + ], + "title": "ScopeUpdateRequest" + }, + "SendCardRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "to_id": { + "type": "string", + "title": "To Id" + }, + "card_wxid": { + "type": "string", + "title": "Card Wxid" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "to_id", + "card_wxid" + ], + "title": "SendCardRequest" + }, + "SendMessageRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "to_id": { + "type": "string", + "title": "To Id" + }, + "content": { + "type": "string", + "title": "Content" + }, + "msg_type": { + "$ref": "#/components/schemas/MessageType", + "default": "text" + }, + "media_url": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Media Url" + }, + "at_list": { + "anyOf": [ + { + "items": { + "type": "string" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "At List" + }, + "timeout_seconds": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "null" + } + ], + "title": "Timeout Seconds" + }, + "channel": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Channel" + }, + "hook_config": { + "anyOf": [ + { + "additionalProperties": true, + "type": "object" + }, + { + "type": "null" + } + ], + "title": "Hook Config" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "to_id", + "content" + ], + "title": "SendMessageRequest", + "description": "发送消息请求" + }, + "SetAvatarRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "image_path": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Image Path" + } + }, + "type": "object", + "required": [ + "device_id", + "platform" + ], + "title": "SetAvatarRequest" + }, + "SetGenderRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "gender": { + "type": "string", + "title": "Gender" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "gender" + ], + "title": "SetGenderRequest" + }, + "SetGroupNameRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "group_id": { + "type": "string", + "title": "Group Id" + }, + "group_name": { + "type": "string", + "title": "Group Name" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "group_id", + "group_name" + ], + "title": "SetGroupNameRequest", + "description": "设置群名请求" + }, + "SetGroupNoticeRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "group_id": { + "type": "string", + "title": "Group Id" + }, + "notice": { + "type": "string", + "title": "Notice" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "group_id", + "notice" + ], + "title": "SetGroupNoticeRequest", + "description": "设置群公告请求" + }, + "SetGroupWelcomeRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "group_id": { + "type": "string", + "title": "Group Id" + }, + "welcome_text": { + "type": "string", + "title": "Welcome Text" + }, + "welcome_image": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Welcome Image" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "group_id", + "welcome_text" + ], + "title": "SetGroupWelcomeRequest", + "description": "设置群欢迎语请求" + }, + "SetNicknameRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "nickname": { + "type": "string", + "title": "Nickname" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "nickname" + ], + "title": "SetNicknameRequest" + }, + "SetRegionRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "region": { + "type": "string", + "title": "Region" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "region" + ], + "title": "SetRegionRequest" + }, + "SetRemarkRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "user_id": { + "type": "string", + "title": "User Id" + }, + "remark": { + "type": "string", + "title": "Remark" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "user_id", + "remark" + ], + "title": "SetRemarkRequest", + "description": "设置备注请求" + }, + "SetSignatureRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "signature": { + "type": "string", + "title": "Signature" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "signature" + ], + "title": "SetSignatureRequest" + }, + "ShareChannelRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "video_id": { + "type": "string", + "title": "Video Id" + }, + "to_id": { + "type": "string", + "title": "To Id" + } + }, + "type": "object", + "required": [ + "device_id", + "video_id", + "to_id" + ], + "title": "ShareChannelRequest" + }, + "ShareMiniProgramRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "app_id": { + "type": "string", + "title": "App Id" + }, + "to_id": { + "type": "string", + "title": "To Id" + }, + "title": { + "type": "string", + "title": "Title", + "default": "" + } + }, + "type": "object", + "required": [ + "device_id", + "app_id", + "to_id" + ], + "title": "ShareMiniProgramRequest" + }, + "ShortcutCreate": { + "properties": { + "name": { + "type": "string", + "title": "Name" + }, + "description": { + "type": "string", + "title": "Description" + }, + "steps": { + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array", + "title": "Steps" + } + }, + "type": "object", + "required": [ + "name", + "description", + "steps" + ], + "title": "ShortcutCreate" + }, + "ShortcutExecute": { + "properties": { + "variables": { + "anyOf": [ + { + "additionalProperties": { + "type": "string" + }, + "type": "object" + }, + { + "type": "null" + } + ], + "title": "Variables" + } + }, + "type": "object", + "title": "ShortcutExecute" + }, + "SimHeartbeatRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + } + }, + "type": "object", + "required": [ + "device_id" + ], + "title": "SimHeartbeatRequest" + }, + "SimHookEventRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "type": "string", + "title": "Platform", + "default": "wechat" + }, + "event_type": { + "type": "string", + "title": "Event Type", + "default": "message_received" + }, + "payload": { + "additionalProperties": true, + "type": "object", + "title": "Payload" + } + }, + "type": "object", + "required": [ + "device_id" + ], + "title": "SimHookEventRequest" + }, + "SimRegisterRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "project_id": { + "type": "string", + "title": "Project Id", + "default": "cunkebao" + }, + "model": { + "type": "string", + "title": "Model", + "default": "Simulator Device" + }, + "platform": { + "type": "string", + "title": "Platform", + "default": "android" + }, + "capabilities": { + "items": { + "type": "string" + }, + "type": "array", + "title": "Capabilities" + } + }, + "type": "object", + "required": [ + "device_id" + ], + "title": "SimRegisterRequest" + }, + "StandingOrderRequest": { + "properties": { + "order": { + "type": "string", + "title": "Order" + } + }, + "type": "object", + "required": [ + "order" + ], + "title": "StandingOrderRequest", + "description": "常驻指令推送请求" + }, + "StartCaptureRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + } + }, + "type": "object", + "required": [ + "device_id" + ], + "title": "StartCaptureRequest" + }, + "StopCaptureRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + } + }, + "type": "object", + "required": [ + "device_id" + ], + "title": "StopCaptureRequest" + }, + "SwipeRequest": { + "properties": { + "direction": { + "type": "string", + "title": "Direction" + }, + "scale": { + "type": "number", + "title": "Scale", + "default": 0.5 + } + }, + "type": "object", + "required": [ + "direction" + ], + "title": "SwipeRequest" + }, + "ToggleRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "enable": { + "type": "boolean", + "title": "Enable", + "default": true + } + }, + "type": "object", + "required": [ + "device_id" + ], + "title": "ToggleRequest" + }, + "TransferRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "to_id": { + "type": "string", + "title": "To Id" + }, + "amount": { + "type": "string", + "title": "Amount" + }, + "description": { + "type": "string", + "title": "Description", + "default": "" + } + }, + "type": "object", + "required": [ + "device_id", + "to_id", + "amount" + ], + "title": "TransferRequest" + }, + "UnblockAccountRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "helper_wxid": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Helper Wxid" + } + }, + "type": "object", + "required": [ + "device_id", + "platform" + ], + "title": "UnblockAccountRequest" + }, + "UnifiedExecuteRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "action": { + "type": "string", + "title": "Action" + }, + "params": { + "additionalProperties": true, + "type": "object", + "title": "Params" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + } + }, + "type": "object", + "required": [ + "device_id", + "action" + ], + "title": "UnifiedExecuteRequest" + }, + "ValidationError": { + "properties": { + "loc": { + "items": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "integer" + } + ] + }, + "type": "array", + "title": "Location" + }, + "msg": { + "type": "string", + "title": "Message" + }, + "type": { + "type": "string", + "title": "Error Type" + } + }, + "type": "object", + "required": [ + "loc", + "msg", + "type" + ], + "title": "ValidationError" + }, + "VoiceCommandRequest": { + "properties": { + "text": { + "type": "string", + "title": "Text" + }, + "device_id": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Device Id" + }, + "project_id": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Project Id" + }, + "execute": { + "type": "boolean", + "title": "Execute", + "default": true + } + }, + "type": "object", + "required": [ + "text" + ], + "title": "VoiceCommandRequest", + "description": "语音命令请求" + }, + "VoiceCommandResponse": { + "properties": { + "success": { + "type": "boolean", + "title": "Success" + }, + "message": { + "type": "string", + "title": "Message" + }, + "text": { + "type": "string", + "title": "Text" + }, + "actions": { + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array", + "title": "Actions" + }, + "executed": { + "type": "boolean", + "title": "Executed", + "default": false + } + }, + "type": "object", + "required": [ + "success", + "message", + "text", + "actions" + ], + "title": "VoiceCommandResponse", + "description": "语音命令响应" + }, + "WechatBaseRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + } + }, + "type": "object", + "required": [ + "device_id" + ], + "title": "WechatBaseRequest" + }, + "WxidRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "timeout": { + "type": "integer", + "title": "Timeout", + "default": 30 + }, + "wxid": { + "type": "string", + "title": "Wxid" + } + }, + "type": "object", + "required": [ + "device_id", + "wxid" + ], + "title": "WxidRequest" + }, + "routers__adb__ClickTextRequest": { + "properties": { + "text": { + "type": "string", + "title": "Text" + }, + "timeout": { + "type": "number", + "title": "Timeout", + "default": 10 + } + }, + "type": "object", + "required": [ + "text" + ], + "title": "ClickTextRequest" + }, + "routers__adb__InputRequest": { + "properties": { + "text": { + "type": "string", + "title": "Text" + }, + "clear": { + "type": "boolean", + "title": "Clear", + "default": true + } + }, + "type": "object", + "required": [ + "text" + ], + "title": "InputRequest" + }, + "routers__devices__ClickRequest": { + "properties": { + "x": { + "type": "integer", + "title": "X" + }, + "y": { + "type": "integer", + "title": "Y" + } + }, + "type": "object", + "required": [ + "x", + "y" + ], + "title": "ClickRequest", + "description": "点击请求" + }, + "routers__devices__SwipeRequest": { + "properties": { + "direction": { + "type": "string", + "title": "Direction" + }, + "scale": { + "type": "number", + "title": "Scale", + "default": 0.8 + } + }, + "type": "object", + "required": [ + "direction" + ], + "title": "SwipeRequest", + "description": "滑动请求" + }, + "routers__hook_modules__DeployScriptRequest": { + "properties": { + "device_ids": { + "items": { + "type": "string" + }, + "type": "array", + "title": "Device Ids" + }, + "auto_reload": { + "type": "boolean", + "title": "Auto Reload", + "default": true + } + }, + "type": "object", + "required": [ + "device_ids" + ], + "title": "DeployScriptRequest" + }, + "routers__unified__RedPacketRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "to_id": { + "type": "string", + "title": "To Id" + }, + "amount": { + "type": "string", + "title": "Amount" + }, + "message": { + "type": "string", + "title": "Message", + "default": "恭喜发财" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "to_id", + "amount" + ], + "title": "RedPacketRequest" + }, + "routers__unified__TransferRequest": { + "properties": { + "device_id": { + "type": "string", + "title": "Device Id" + }, + "platform": { + "$ref": "#/components/schemas/Platform" + }, + "to_id": { + "type": "string", + "title": "To Id" + }, + "amount": { + "type": "string", + "title": "Amount" + }, + "message": { + "type": "string", + "title": "Message", + "default": "" + } + }, + "type": "object", + "required": [ + "device_id", + "platform", + "to_id", + "amount" + ], + "title": "TransferRequest" + } + } + }, + "tags": [ + { + "name": "消息管理", + "description": "发送/获取/转发/撤回/名片/语音消息 — 8个端点" + }, + { + "name": "好友管理", + "description": "添加/通过/备注/删除/搜索/批量 — 8个端点" + }, + { + "name": "群聊管理", + "description": "创建/邀请/移除/公告/群名/群消息/欢迎语/退群 — 10个端点" + }, + { + "name": "标签管理", + "description": "创建/删除/打标/取标/查人 — 6个端点" + }, + { + "name": "朋友圈管理", + "description": "发布/点赞/评论/删除/封面/可见天数/分享链接 — 8个端点" + }, + { + "name": "个人设置", + "description": "获取资料/昵称/签名/头像/性别/地区 — 6个端点" + }, + { + "name": "账号安全", + "description": "状态/解封/安全中心/改密码/申诉/限制检查 — 9个端点" + }, + { + "name": "收藏管理", + "description": "收藏/收藏列表 — 2个端点" + }, + { + "name": "支付", + "description": "红包/转账/付款码/收款/钱包/账单/领红包 — 7个端点" + }, + { + "name": "聊天设置", + "description": "置顶/免打扰/清空记录 — 3个端点" + }, + { + "name": "小程序", + "description": "打开小程序 — 1个端点" + }, + { + "name": "公众号", + "description": "关注公众号 — 1个端点" + }, + { + "name": "视频号", + "description": "列表/点赞/评论/关注/分享 — 5个端点" + }, + { + "name": "扫一扫", + "description": "扫码/加好友/我的二维码/图片识别 — 4个端点" + }, + { + "name": "通话", + "description": "语音通话/视频通话 — 2个端点" + }, + { + "name": "群发助手", + "description": "群发消息 — 1个端点" + }, + { + "name": "搜一搜", + "description": "微信搜一搜 — 1个端点" + }, + { + "name": "看一看", + "description": "微信看一看 — 1个端点" + }, + { + "name": "微信运动", + "description": "步数/点赞 — 2个端点" + }, + { + "name": "位置", + "description": "发送位置/共享实时位置 — 2个端点" + }, + { + "name": "表情", + "description": "发送表情/表情包列表 — 2个端点" + }, + { + "name": "文件管理", + "description": "发送文件/下载文件 — 2个端点" + }, + { + "name": "设置", + "description": "勿扰/清缓存/检查更新/退出/切换账号 — 5个端点" + }, + { + "name": "设备管理", + "description": "设备列表/状态/截图/ADB控制" + }, + { + "name": "AI Agent", + "description": "自然语言控制手机" + }, + { + "name": "防封监控", + "description": "操作频率/内容/账号生命周期 — 2个端点" + } + ] +} \ No newline at end of file diff --git a/开发文档/5、接口/04-OpenAPI/routes_snapshot.json b/开发文档/5、接口/04-OpenAPI/routes_snapshot.json new file mode 100644 index 0000000000..29ac85ddcc --- /dev/null +++ b/开发文档/5、接口/04-OpenAPI/routes_snapshot.json @@ -0,0 +1,2849 @@ +{ + "count": 328, + "routes": [ + { + "method": "GET", + "path": "/", + "tags": [], + "name": "root" + }, + { + "method": "POST", + "path": "/api/v3/account/appeal-restriction", + "tags": [ + "统一接口", + "账号安全" + ], + "name": "appeal_restriction" + }, + { + "method": "POST", + "path": "/api/v3/account/change-password", + "tags": [ + "统一接口", + "账号安全" + ], + "name": "change_password" + }, + { + "method": "GET", + "path": "/api/v3/account/restrictions", + "tags": [ + "统一接口", + "账号安全" + ], + "name": "check_restrictions" + }, + { + "method": "GET", + "path": "/api/v3/account/safety-center", + "tags": [ + "统一接口", + "账号安全" + ], + "name": "safety_center" + }, + { + "method": "GET", + "path": "/api/v3/account/status", + "tags": [ + "统一接口", + "账号安全" + ], + "name": "check_account_status" + }, + { + "method": "POST", + "path": "/api/v3/account/unblock", + "tags": [ + "统一接口", + "账号安全" + ], + "name": "unblock_account" + }, + { + "method": "POST", + "path": "/api/v3/account/unblock-appeal", + "tags": [ + "统一接口", + "账号安全" + ], + "name": "unblock_appeal" + }, + { + "method": "POST", + "path": "/api/v3/account/unblock-self", + "tags": [ + "统一接口", + "账号安全" + ], + "name": "unblock_self" + }, + { + "method": "POST", + "path": "/api/v3/account/unblock-sms", + "tags": [ + "统一接口", + "账号安全" + ], + "name": "unblock_with_sms" + }, + { + "method": "GET", + "path": "/api/v3/adb/devices", + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "name": "list_devices" + }, + { + "method": "GET", + "path": "/api/v3/adb/devices/{serial}", + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "name": "get_device_info" + }, + { + "method": "GET", + "path": "/api/v3/adb/devices/{serial}/app/current", + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "name": "current_app" + }, + { + "method": "GET", + "path": "/api/v3/adb/devices/{serial}/app/list", + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "name": "list_apps" + }, + { + "method": "POST", + "path": "/api/v3/adb/devices/{serial}/app/start", + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "name": "start_app" + }, + { + "method": "POST", + "path": "/api/v3/adb/devices/{serial}/app/stop", + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "name": "stop_app" + }, + { + "method": "POST", + "path": "/api/v3/adb/devices/{serial}/click", + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "name": "click" + }, + { + "method": "POST", + "path": "/api/v3/adb/devices/{serial}/click-text", + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "name": "click_text" + }, + { + "method": "POST", + "path": "/api/v3/adb/devices/{serial}/input", + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "name": "input_text" + }, + { + "method": "POST", + "path": "/api/v3/adb/devices/{serial}/key", + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "name": "press_key" + }, + { + "method": "POST", + "path": "/api/v3/adb/devices/{serial}/screenshot", + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "name": "screenshot" + }, + { + "method": "POST", + "path": "/api/v3/adb/devices/{serial}/swipe", + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "name": "swipe" + }, + { + "method": "GET", + "path": "/api/v3/adb/devices/{serial}/ui-tree", + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "name": "get_ui_tree" + }, + { + "method": "GET", + "path": "/api/v3/adb/scan", + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "name": "scan_devices" + }, + { + "method": "POST", + "path": "/api/v3/adb/scan", + "tags": [ + "ADB设备控制", + "ADB设备控制" + ], + "name": "scan_devices" + }, + { + "method": "GET", + "path": "/api/v3/agent/download", + "tags": [], + "name": "download_agent" + }, + { + "method": "POST", + "path": "/api/v3/agent/execute", + "tags": [ + "AI Agent" + ], + "name": "execute_task" + }, + { + "method": "GET", + "path": "/api/v3/agent/status/{device_id}", + "tags": [ + "AI Agent" + ], + "name": "get_agent_status" + }, + { + "method": "POST", + "path": "/api/v3/agent/stop/{device_id}", + "tags": [ + "AI Agent" + ], + "name": "stop_agent" + }, + { + "method": "POST", + "path": "/api/v3/ai/brain/batch-execute", + "tags": [ + "AI Agent" + ], + "name": "batch_execute_script" + }, + { + "method": "GET", + "path": "/api/v3/ai/brain/dashboard", + "tags": [ + "AI Agent" + ], + "name": "ai_brain_dashboard" + }, + { + "method": "POST", + "path": "/api/v3/ai/brain/execute-script", + "tags": [ + "AI Agent" + ], + "name": "execute_brain_script" + }, + { + "method": "GET", + "path": "/api/v3/ai/brain/skill-registry", + "tags": [ + "AI Agent" + ], + "name": "get_skill_registry" + }, + { + "method": "POST", + "path": "/api/v3/ai/chat", + "tags": [ + "AI Agent" + ], + "name": "ai_chat" + }, + { + "method": "GET", + "path": "/api/v3/ai/status", + "tags": [ + "AI Agent" + ], + "name": "ai_status" + }, + { + "method": "GET", + "path": "/api/v3/anti-ban/dashboard", + "tags": [ + "统一接口" + ], + "name": "anti_ban_dashboard" + }, + { + "method": "GET", + "path": "/api/v3/anti-ban/device/{device_id}", + "tags": [ + "统一接口" + ], + "name": "anti_ban_device_detail" + }, + { + "method": "POST", + "path": "/api/v3/auto-register/check-state", + "tags": [ + "统一接口", + "自动注册" + ], + "name": "check_wechat_login_state" + }, + { + "method": "POST", + "path": "/api/v3/auto-register/full", + "tags": [ + "统一接口", + "自动注册" + ], + "name": "auto_register_full" + }, + { + "method": "POST", + "path": "/api/v3/auto-register/get-sim-phone", + "tags": [ + "统一接口", + "自动注册" + ], + "name": "get_sim_phone" + }, + { + "method": "POST", + "path": "/api/v3/call/video", + "tags": [ + "统一接口", + "通话" + ], + "name": "video_call" + }, + { + "method": "POST", + "path": "/api/v3/call/voice", + "tags": [ + "统一接口", + "通话" + ], + "name": "voice_call" + }, + { + "method": "GET", + "path": "/api/v3/capture/data/{device_id}", + "tags": [ + "抓包" + ], + "name": "api_capture_data" + }, + { + "method": "POST", + "path": "/api/v3/capture/start", + "tags": [ + "抓包" + ], + "name": "api_start_capture" + }, + { + "method": "GET", + "path": "/api/v3/capture/status/{device_id}", + "tags": [ + "抓包" + ], + "name": "api_capture_status" + }, + { + "method": "POST", + "path": "/api/v3/capture/stop", + "tags": [ + "抓包" + ], + "name": "api_stop_capture" + }, + { + "method": "POST", + "path": "/api/v3/chat/clear-history", + "tags": [ + "统一接口", + "聊天设置" + ], + "name": "clear_chat_history" + }, + { + "method": "POST", + "path": "/api/v3/chat/set-mute", + "tags": [ + "统一接口", + "聊天设置" + ], + "name": "set_mute_chat" + }, + { + "method": "POST", + "path": "/api/v3/chat/set-top", + "tags": [ + "统一接口", + "聊天设置" + ], + "name": "set_chat_top" + }, + { + "method": "POST", + "path": "/api/v3/comment/reply", + "tags": [ + "统一接口", + "消息管理" + ], + "name": "reply_comment" + }, + { + "method": "GET", + "path": "/api/v3/connection/modes", + "tags": [ + "连接协议" + ], + "name": "get_all_connection_modes" + }, + { + "method": "GET", + "path": "/api/v3/connection/modes/{device_id}", + "tags": [ + "连接协议" + ], + "name": "get_device_connection_modes" + }, + { + "method": "GET", + "path": "/api/v3/connection/protocol", + "tags": [ + "连接协议" + ], + "name": "get_connection_protocol" + }, + { + "method": "POST", + "path": "/api/v3/connection/simulate/heartbeat", + "tags": [ + "连接协议" + ], + "name": "simulate_heartbeat" + }, + { + "method": "POST", + "path": "/api/v3/connection/simulate/hook-event", + "tags": [ + "连接协议" + ], + "name": "simulate_hook_event" + }, + { + "method": "POST", + "path": "/api/v3/connection/simulate/register", + "tags": [ + "连接协议" + ], + "name": "simulate_register" + }, + { + "method": "GET", + "path": "/api/v3/connection/status", + "tags": [ + "连接协议" + ], + "name": "get_connection_status" + }, + { + "method": "GET", + "path": "/api/v3/contacts", + "tags": [ + "统一接口", + "好友管理" + ], + "name": "get_contacts" + }, + { + "method": "GET", + "path": "/api/v3/contacts/search", + "tags": [ + "统一接口", + "好友管理" + ], + "name": "search_contacts" + }, + { + "method": "POST", + "path": "/api/v3/cunke-bao/batch-contacts", + "tags": [ + "存客宝对接", + "存客宝对接" + ], + "name": "batch_report_contacts" + }, + { + "method": "GET", + "path": "/api/v3/cunke-bao/config", + "tags": [ + "存客宝对接", + "存客宝对接" + ], + "name": "get_config" + }, + { + "method": "POST", + "path": "/api/v3/cunke-bao/config", + "tags": [ + "存客宝对接", + "存客宝对接" + ], + "name": "set_config" + }, + { + "method": "POST", + "path": "/api/v3/cunke-bao/hook/batch-events", + "tags": [ + "存客宝对接", + "存客宝对接", + "Frida Hook" + ], + "name": "hook_batch_events" + }, + { + "method": "POST", + "path": "/api/v3/cunke-bao/hook/friend-add", + "tags": [ + "存客宝对接", + "存客宝对接", + "Frida Hook" + ], + "name": "hook_friend_add" + }, + { + "method": "POST", + "path": "/api/v3/cunke-bao/hook/group-change", + "tags": [ + "存客宝对接", + "存客宝对接", + "Frida Hook" + ], + "name": "hook_group_change" + }, + { + "method": "POST", + "path": "/api/v3/cunke-bao/report-lead", + "tags": [ + "存客宝对接", + "存客宝对接" + ], + "name": "report_lead" + }, + { + "method": "GET", + "path": "/api/v3/cunke-bao/stats", + "tags": [ + "存客宝对接", + "存客宝对接" + ], + "name": "get_stats" + }, + { + "method": "GET", + "path": "/api/v3/devices", + "tags": [ + "设备管理" + ], + "name": "get_devices" + }, + { + "method": "GET", + "path": "/api/v3/devices/{device_id}", + "tags": [ + "设备管理" + ], + "name": "get_device" + }, + { + "method": "POST", + "path": "/api/v3/devices/{device_id}/ai/execute", + "tags": [ + "设备管理" + ], + "name": "ai_execute" + }, + { + "method": "POST", + "path": "/api/v3/devices/{device_id}/ai/queue-task", + "tags": [ + "设备管理" + ], + "name": "queue_ai_task" + }, + { + "method": "POST", + "path": "/api/v3/devices/{device_id}/ai/standing-order", + "tags": [ + "设备管理" + ], + "name": "push_standing_order" + }, + { + "method": "GET", + "path": "/api/v3/devices/{device_id}/ai/status", + "tags": [ + "设备管理" + ], + "name": "get_ai_brain_status" + }, + { + "method": "POST", + "path": "/api/v3/devices/{device_id}/ai/task", + "tags": [ + "设备管理" + ], + "name": "push_ai_task" + }, + { + "method": "POST", + "path": "/api/v3/devices/{device_id}/click", + "tags": [ + "设备管理" + ], + "name": "click" + }, + { + "method": "POST", + "path": "/api/v3/devices/{device_id}/click-text", + "tags": [ + "设备管理" + ], + "name": "click_text" + }, + { + "method": "POST", + "path": "/api/v3/devices/{device_id}/execute", + "tags": [ + "设备管理" + ], + "name": "execute_script" + }, + { + "method": "GET", + "path": "/api/v3/devices/{device_id}/guard-events", + "tags": [ + "设备管理", + "连接守护" + ], + "name": "get_guard_events" + }, + { + "method": "POST", + "path": "/api/v3/devices/{device_id}/guard-events", + "tags": [ + "设备管理", + "连接守护" + ], + "name": "post_guard_event" + }, + { + "method": "GET", + "path": "/api/v3/devices/{device_id}/health", + "tags": [ + "设备管理" + ], + "name": "device_health" + }, + { + "method": "GET", + "path": "/api/v3/devices/{device_id}/health/events", + "tags": [ + "设备管理" + ], + "name": "device_health_events" + }, + { + "method": "GET", + "path": "/api/v3/devices/{device_id}/heartbeat", + "tags": [ + "设备管理" + ], + "name": "get_device_heartbeat" + }, + { + "method": "POST", + "path": "/api/v3/devices/{device_id}/heartbeat/config", + "tags": [ + "设备管理" + ], + "name": "set_device_heartbeat" + }, + { + "method": "POST", + "path": "/api/v3/devices/{device_id}/input", + "tags": [ + "设备管理" + ], + "name": "input_text" + }, + { + "method": "GET", + "path": "/api/v3/devices/{device_id}/modules", + "tags": [ + "Hook模块管理" + ], + "name": "get_device_modules" + }, + { + "method": "POST", + "path": "/api/v3/devices/{device_id}/modules/reload", + "tags": [ + "Hook模块管理" + ], + "name": "reload_device_modules" + }, + { + "method": "GET", + "path": "/api/v3/devices/{device_id}/modules/{module_id}/logs", + "tags": [ + "Hook模块管理" + ], + "name": "get_device_module_logs" + }, + { + "method": "POST", + "path": "/api/v3/devices/{device_id}/screenshot", + "tags": [ + "设备管理" + ], + "name": "screenshot" + }, + { + "method": "POST", + "path": "/api/v3/devices/{device_id}/swipe", + "tags": [ + "设备管理" + ], + "name": "swipe" + }, + { + "method": "GET", + "path": "/api/v3/devices/{device_id}/ui-tree", + "tags": [ + "设备管理" + ], + "name": "get_ui_tree" + }, + { + "method": "GET", + "path": "/api/v3/discover/top-stories", + "tags": [ + "统一接口", + "看一看" + ], + "name": "top_stories" + }, + { + "method": "POST", + "path": "/api/v3/discovery/beacon/start", + "tags": [ + "设备发现", + "discovery" + ], + "name": "start_beacon" + }, + { + "method": "POST", + "path": "/api/v3/discovery/beacon/stop", + "tags": [ + "设备发现", + "discovery" + ], + "name": "stop_beacon" + }, + { + "method": "GET", + "path": "/api/v3/discovery/last-scan", + "tags": [ + "设备发现", + "discovery" + ], + "name": "get_last_scan" + }, + { + "method": "POST", + "path": "/api/v3/discovery/listen-beacon", + "tags": [ + "设备发现", + "discovery" + ], + "name": "listen_beacon" + }, + { + "method": "POST", + "path": "/api/v3/discovery/scan-lan", + "tags": [ + "设备发现", + "discovery" + ], + "name": "scan_lan" + }, + { + "method": "GET", + "path": "/api/v3/discovery/server-info", + "tags": [ + "设备发现", + "discovery" + ], + "name": "get_server_info" + }, + { + "method": "POST", + "path": "/api/v3/emoji/send", + "tags": [ + "统一接口", + "表情" + ], + "name": "send_emoji" + }, + { + "method": "GET", + "path": "/api/v3/emoji/stickers", + "tags": [ + "统一接口", + "表情" + ], + "name": "get_sticker_list" + }, + { + "method": "GET", + "path": "/api/v3/experience/average-duration", + "tags": [ + "经验库", + "经验库" + ], + "name": "get_average_duration" + }, + { + "method": "GET", + "path": "/api/v3/experience/elements", + "tags": [ + "经验库", + "经验库" + ], + "name": "get_learned_elements" + }, + { + "method": "GET", + "path": "/api/v3/experience/elements/{app}", + "tags": [ + "经验库", + "经验库" + ], + "name": "get_app_elements" + }, + { + "method": "GET", + "path": "/api/v3/experience/operations", + "tags": [ + "经验库", + "经验库" + ], + "name": "get_operations" + }, + { + "method": "POST", + "path": "/api/v3/experience/operations/record", + "tags": [ + "经验库", + "经验库" + ], + "name": "record_operation" + }, + { + "method": "GET", + "path": "/api/v3/experience/shortcuts", + "tags": [ + "经验库", + "经验库" + ], + "name": "list_shortcuts" + }, + { + "method": "POST", + "path": "/api/v3/experience/shortcuts", + "tags": [ + "经验库", + "经验库" + ], + "name": "create_shortcut" + }, + { + "method": "GET", + "path": "/api/v3/experience/shortcuts/{name}", + "tags": [ + "经验库", + "经验库" + ], + "name": "get_shortcut" + }, + { + "method": "POST", + "path": "/api/v3/experience/shortcuts/{name}/execute/{device_id}", + "tags": [ + "经验库", + "经验库" + ], + "name": "execute_shortcut" + }, + { + "method": "GET", + "path": "/api/v3/experience/statistics", + "tags": [ + "经验库", + "经验库" + ], + "name": "get_statistics" + }, + { + "method": "GET", + "path": "/api/v3/experience/success-rate", + "tags": [ + "经验库", + "经验库" + ], + "name": "get_success_rate" + }, + { + "method": "GET", + "path": "/api/v3/experience/suggest/coordinates", + "tags": [ + "经验库", + "经验库" + ], + "name": "suggest_coordinates" + }, + { + "method": "POST", + "path": "/api/v3/favorites/add", + "tags": [ + "统一接口", + "收藏管理" + ], + "name": "add_favorite" + }, + { + "method": "GET", + "path": "/api/v3/favorites/list", + "tags": [ + "统一接口", + "收藏管理" + ], + "name": "get_favorites" + }, + { + "method": "POST", + "path": "/api/v3/file/download", + "tags": [ + "统一接口", + "文件管理" + ], + "name": "download_file" + }, + { + "method": "POST", + "path": "/api/v3/file/send", + "tags": [ + "统一接口", + "文件管理" + ], + "name": "send_file" + }, + { + "method": "GET", + "path": "/api/v3/frida/actions", + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "name": "list_supported_actions" + }, + { + "method": "POST", + "path": "/api/v3/frida/connect", + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "name": "connect_device" + }, + { + "method": "GET", + "path": "/api/v3/frida/deploy/install-script", + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "name": "get_install_command" + }, + { + "method": "POST", + "path": "/api/v3/frida/deploy/script", + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "name": "generate_deploy_script" + }, + { + "method": "GET", + "path": "/api/v3/frida/device/{device_id}", + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "name": "get_device" + }, + { + "method": "GET", + "path": "/api/v3/frida/devices", + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "name": "list_devices" + }, + { + "method": "POST", + "path": "/api/v3/frida/disconnect/{device_id}", + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "name": "disconnect_device" + }, + { + "method": "POST", + "path": "/api/v3/frida/discover", + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "name": "discover_devices" + }, + { + "method": "POST", + "path": "/api/v3/frida/execute", + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "name": "execute_command" + }, + { + "method": "POST", + "path": "/api/v3/frida/execute/batch", + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "name": "execute_batch" + }, + { + "method": "POST", + "path": "/api/v3/frida/register", + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "name": "register_device" + }, + { + "method": "GET", + "path": "/api/v3/frida/status", + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "name": "frida_status" + }, + { + "method": "DELETE", + "path": "/api/v3/frida/unregister/{device_id}", + "tags": [ + "Frida无线管理", + "Frida无线管理" + ], + "name": "unregister_device" + }, + { + "method": "POST", + "path": "/api/v3/friend/accept", + "tags": [ + "统一接口", + "好友管理" + ], + "name": "accept_friend" + }, + { + "method": "POST", + "path": "/api/v3/friend/add", + "tags": [ + "统一接口", + "好友管理" + ], + "name": "add_friend" + }, + { + "method": "POST", + "path": "/api/v3/friend/batch-add", + "tags": [ + "统一接口", + "好友管理" + ], + "name": "batch_add_friend" + }, + { + "method": "POST", + "path": "/api/v3/friend/delete", + "tags": [ + "统一接口", + "好友管理" + ], + "name": "delete_friend" + }, + { + "method": "GET", + "path": "/api/v3/friend/info", + "tags": [ + "统一接口", + "好友管理" + ], + "name": "get_friend_info" + }, + { + "method": "POST", + "path": "/api/v3/friend/set-remark", + "tags": [ + "统一接口", + "好友管理" + ], + "name": "set_friend_remark" + }, + { + "method": "POST", + "path": "/api/v3/gateway/fleet/broadcast", + "tags": [ + "外部对接网关", + "外部对接网关" + ], + "name": "fleet_broadcast" + }, + { + "method": "POST", + "path": "/api/v3/gateway/fleet/group", + "tags": [ + "外部对接网关", + "外部对接网关" + ], + "name": "create_device_group" + }, + { + "method": "GET", + "path": "/api/v3/gateway/fleet/groups", + "tags": [ + "外部对接网关", + "外部对接网关" + ], + "name": "list_device_groups" + }, + { + "method": "GET", + "path": "/api/v3/gateway/fleet/status", + "tags": [ + "外部对接网关", + "外部对接网关" + ], + "name": "fleet_status" + }, + { + "method": "GET", + "path": "/api/v3/gateway/info", + "tags": [ + "外部对接网关", + "外部对接网关" + ], + "name": "gateway_info" + }, + { + "method": "GET", + "path": "/api/v3/gateway/journey", + "tags": [ + "外部对接网关", + "外部对接网关" + ], + "name": "get_all_journeys" + }, + { + "method": "GET", + "path": "/api/v3/gateway/journey/{device_id}", + "tags": [ + "外部对接网关", + "外部对接网关" + ], + "name": "get_device_journey" + }, + { + "method": "POST", + "path": "/api/v3/gateway/mcp/call", + "tags": [ + "外部对接网关", + "外部对接网关" + ], + "name": "mcp_call_tool" + }, + { + "method": "GET", + "path": "/api/v3/gateway/mcp/tools", + "tags": [ + "外部对接网关", + "外部对接网关" + ], + "name": "mcp_list_tools" + }, + { + "method": "POST", + "path": "/api/v3/gateway/v1/chat/completions", + "tags": [ + "外部对接网关", + "外部对接网关" + ], + "name": "openai_compatible_chat" + }, + { + "method": "GET", + "path": "/api/v3/gateway/v1/models", + "tags": [ + "外部对接网关", + "外部对接网关" + ], + "name": "list_models" + }, + { + "method": "POST", + "path": "/api/v3/group/create", + "tags": [ + "统一接口", + "群聊管理" + ], + "name": "create_group" + }, + { + "method": "POST", + "path": "/api/v3/group/invite", + "tags": [ + "统一接口", + "群聊管理" + ], + "name": "invite_to_group" + }, + { + "method": "GET", + "path": "/api/v3/group/list", + "tags": [ + "统一接口", + "群聊管理" + ], + "name": "get_group_list" + }, + { + "method": "GET", + "path": "/api/v3/group/members", + "tags": [ + "统一接口", + "群聊管理" + ], + "name": "get_group_members" + }, + { + "method": "POST", + "path": "/api/v3/group/quit", + "tags": [ + "统一接口", + "群聊管理" + ], + "name": "quit_group" + }, + { + "method": "POST", + "path": "/api/v3/group/remove", + "tags": [ + "统一接口", + "群聊管理" + ], + "name": "remove_from_group" + }, + { + "method": "POST", + "path": "/api/v3/group/send-message", + "tags": [ + "统一接口", + "群聊管理" + ], + "name": "send_group_message" + }, + { + "method": "POST", + "path": "/api/v3/group/set-name", + "tags": [ + "统一接口", + "群聊管理" + ], + "name": "set_group_name" + }, + { + "method": "POST", + "path": "/api/v3/group/set-notice", + "tags": [ + "统一接口", + "群聊管理" + ], + "name": "set_group_notice" + }, + { + "method": "POST", + "path": "/api/v3/group/set-welcome", + "tags": [ + "统一接口", + "群聊管理" + ], + "name": "set_group_welcome" + }, + { + "method": "GET", + "path": "/api/v3/guard-events/all", + "tags": [ + "设备管理", + "连接守护" + ], + "name": "get_all_guard_events" + }, + { + "method": "GET", + "path": "/api/v3/heartbeat/dashboard", + "tags": [ + "设备管理" + ], + "name": "heartbeat_dashboard" + }, + { + "method": "GET", + "path": "/api/v3/heartbeat/events", + "tags": [ + "设备管理" + ], + "name": "all_health_events" + }, + { + "method": "GET", + "path": "/api/v3/hook/actions", + "tags": [ + "统一接口", + "Hook模块管理" + ], + "name": "hook_actions" + }, + { + "method": "GET", + "path": "/api/v3/hook/data/{device_id}", + "tags": [ + "统一接口", + "Hook模块管理" + ], + "name": "hook_data" + }, + { + "method": "GET", + "path": "/api/v3/hook/events", + "tags": [ + "Hook模块管理" + ], + "name": "list_hook_events" + }, + { + "method": "POST", + "path": "/api/v3/hook/events", + "tags": [ + "Hook模块管理" + ], + "name": "ingest_hook_event" + }, + { + "method": "POST", + "path": "/api/v3/hook/execute", + "tags": [ + "统一接口", + "Hook模块管理" + ], + "name": "hook_execute" + }, + { + "method": "GET", + "path": "/api/v3/hook/probe/{device_id}", + "tags": [ + "统一接口", + "Hook模块管理" + ], + "name": "hook_probe" + }, + { + "method": "POST", + "path": "/api/v3/location/send", + "tags": [ + "统一接口", + "位置" + ], + "name": "send_location" + }, + { + "method": "POST", + "path": "/api/v3/location/share-realtime", + "tags": [ + "统一接口", + "位置" + ], + "name": "share_real_time_location" + }, + { + "method": "POST", + "path": "/api/v3/mass-send", + "tags": [ + "统一接口", + "群发助手" + ], + "name": "mass_send" + }, + { + "method": "POST", + "path": "/api/v3/message/batch-send", + "tags": [ + "统一接口", + "消息管理" + ], + "name": "batch_send_message" + }, + { + "method": "POST", + "path": "/api/v3/message/forward", + "tags": [ + "统一接口", + "消息管理" + ], + "name": "forward_message" + }, + { + "method": "POST", + "path": "/api/v3/message/list", + "tags": [ + "统一接口", + "消息管理" + ], + "name": "get_messages" + }, + { + "method": "POST", + "path": "/api/v3/message/recall", + "tags": [ + "统一接口", + "消息管理" + ], + "name": "recall_message" + }, + { + "method": "POST", + "path": "/api/v3/message/send", + "tags": [ + "统一接口", + "消息管理" + ], + "name": "send_message" + }, + { + "method": "POST", + "path": "/api/v3/message/send-card", + "tags": [ + "统一接口", + "消息管理" + ], + "name": "send_card" + }, + { + "method": "POST", + "path": "/api/v3/message/voice", + "tags": [ + "统一接口", + "消息管理" + ], + "name": "send_voice_message" + }, + { + "method": "POST", + "path": "/api/v3/miniprogram/open", + "tags": [ + "统一接口", + "小程序" + ], + "name": "open_mini_program" + }, + { + "method": "GET", + "path": "/api/v3/modules", + "tags": [ + "Hook模块管理" + ], + "name": "list_modules" + }, + { + "method": "POST", + "path": "/api/v3/modules", + "tags": [ + "Hook模块管理" + ], + "name": "create_module" + }, + { + "method": "DELETE", + "path": "/api/v3/modules/{module_id}", + "tags": [ + "Hook模块管理" + ], + "name": "delete_module" + }, + { + "method": "GET", + "path": "/api/v3/modules/{module_id}", + "tags": [ + "Hook模块管理" + ], + "name": "get_module" + }, + { + "method": "PUT", + "path": "/api/v3/modules/{module_id}", + "tags": [ + "Hook模块管理" + ], + "name": "update_module" + }, + { + "method": "POST", + "path": "/api/v3/modules/{module_id}/disable", + "tags": [ + "Hook模块管理" + ], + "name": "disable_module" + }, + { + "method": "POST", + "path": "/api/v3/modules/{module_id}/enable", + "tags": [ + "Hook模块管理" + ], + "name": "enable_module" + }, + { + "method": "PUT", + "path": "/api/v3/modules/{module_id}/scope", + "tags": [ + "Hook模块管理" + ], + "name": "set_module_scope" + }, + { + "method": "POST", + "path": "/api/v3/moments/comment", + "tags": [ + "统一接口", + "朋友圈管理" + ], + "name": "comment_moments" + }, + { + "method": "POST", + "path": "/api/v3/moments/delete", + "tags": [ + "统一接口", + "朋友圈管理" + ], + "name": "delete_moments" + }, + { + "method": "POST", + "path": "/api/v3/moments/like", + "tags": [ + "统一接口", + "朋友圈管理" + ], + "name": "like_moments" + }, + { + "method": "POST", + "path": "/api/v3/moments/list", + "tags": [ + "统一接口", + "朋友圈管理" + ], + "name": "get_moments" + }, + { + "method": "POST", + "path": "/api/v3/moments/post", + "tags": [ + "统一接口", + "朋友圈管理" + ], + "name": "post_moments" + }, + { + "method": "POST", + "path": "/api/v3/moments/set-cover", + "tags": [ + "统一接口", + "朋友圈管理" + ], + "name": "set_moments_cover" + }, + { + "method": "POST", + "path": "/api/v3/moments/set-privacy", + "tags": [ + "统一接口", + "朋友圈管理" + ], + "name": "set_moments_privacy" + }, + { + "method": "POST", + "path": "/api/v3/moments/share-link", + "tags": [ + "统一接口", + "朋友圈管理" + ], + "name": "share_link_to_moments" + }, + { + "method": "POST", + "path": "/api/v3/official-account/follow", + "tags": [ + "统一接口", + "公众号" + ], + "name": "follow_official_account" + }, + { + "method": "GET", + "path": "/api/v3/payment/code", + "tags": [ + "统一接口", + "支付" + ], + "name": "show_payment_code" + }, + { + "method": "POST", + "path": "/api/v3/payment/receive", + "tags": [ + "统一接口", + "支付" + ], + "name": "receive_payment" + }, + { + "method": "POST", + "path": "/api/v3/payment/receive-red-packet", + "tags": [ + "统一接口", + "支付" + ], + "name": "receive_red_packet" + }, + { + "method": "POST", + "path": "/api/v3/payment/red-packet", + "tags": [ + "统一接口", + "支付" + ], + "name": "send_red_packet" + }, + { + "method": "GET", + "path": "/api/v3/payment/transactions", + "tags": [ + "统一接口", + "支付" + ], + "name": "view_transactions" + }, + { + "method": "POST", + "path": "/api/v3/payment/transfer", + "tags": [ + "统一接口", + "支付" + ], + "name": "send_transfer" + }, + { + "method": "GET", + "path": "/api/v3/payment/wallet", + "tags": [ + "统一接口", + "支付" + ], + "name": "view_wallet" + }, + { + "method": "GET", + "path": "/api/v3/profile/get", + "tags": [ + "统一接口", + "个人设置" + ], + "name": "get_profile" + }, + { + "method": "POST", + "path": "/api/v3/profile/set-avatar", + "tags": [ + "统一接口", + "个人设置" + ], + "name": "set_avatar" + }, + { + "method": "POST", + "path": "/api/v3/profile/set-gender", + "tags": [ + "统一接口", + "个人设置" + ], + "name": "set_gender" + }, + { + "method": "POST", + "path": "/api/v3/profile/set-nickname", + "tags": [ + "统一接口", + "个人设置" + ], + "name": "set_nickname" + }, + { + "method": "POST", + "path": "/api/v3/profile/set-region", + "tags": [ + "统一接口", + "个人设置" + ], + "name": "set_region" + }, + { + "method": "POST", + "path": "/api/v3/profile/set-signature", + "tags": [ + "统一接口", + "个人设置" + ], + "name": "set_signature" + }, + { + "method": "GET", + "path": "/api/v3/projects", + "tags": [ + "项目管理", + "项目管理" + ], + "name": "list_projects" + }, + { + "method": "GET", + "path": "/api/v3/projects/{project_id}", + "tags": [ + "项目管理", + "项目管理" + ], + "name": "get_project" + }, + { + "method": "POST", + "path": "/api/v3/projects/{project_id}/broadcast", + "tags": [ + "项目管理", + "项目管理" + ], + "name": "broadcast_command" + }, + { + "method": "GET", + "path": "/api/v3/projects/{project_id}/devices", + "tags": [ + "项目管理", + "项目管理" + ], + "name": "get_project_devices" + }, + { + "method": "POST", + "path": "/api/v3/projects/{project_id}/devices/{device_id}/execute", + "tags": [ + "项目管理", + "项目管理" + ], + "name": "execute_on_device" + }, + { + "method": "POST", + "path": "/api/v3/projects/{project_id}/execute", + "tags": [ + "项目管理", + "项目管理" + ], + "name": "execute_command" + }, + { + "method": "POST", + "path": "/api/v3/qrcode/generate", + "tags": [ + "二维码", + "二维码" + ], + "name": "generate_qrcode" + }, + { + "method": "GET", + "path": "/api/v3/qrcode/html/{project_id}", + "tags": [ + "二维码", + "二维码" + ], + "name": "get_qrcode_html" + }, + { + "method": "GET", + "path": "/api/v3/qrcode/image/{project_id}", + "tags": [ + "二维码", + "二维码" + ], + "name": "get_qrcode_image" + }, + { + "method": "GET", + "path": "/api/v3/registry/fleet/aggregate", + "tags": [ + "多服务器注册中心", + "多服务器注册中心" + ], + "name": "fleet_aggregate" + }, + { + "method": "GET", + "path": "/api/v3/registry/info", + "tags": [ + "多服务器注册中心", + "多服务器注册中心" + ], + "name": "registry_info" + }, + { + "method": "GET", + "path": "/api/v3/registry/nodes", + "tags": [ + "多服务器注册中心", + "多服务器注册中心" + ], + "name": "list_nodes" + }, + { + "method": "POST", + "path": "/api/v3/registry/nodes/heartbeat", + "tags": [ + "多服务器注册中心", + "多服务器注册中心" + ], + "name": "node_heartbeat" + }, + { + "method": "POST", + "path": "/api/v3/registry/nodes/register", + "tags": [ + "多服务器注册中心", + "多服务器注册中心" + ], + "name": "register_node" + }, + { + "method": "DELETE", + "path": "/api/v3/registry/nodes/{node_id}", + "tags": [ + "多服务器注册中心", + "多服务器注册中心" + ], + "name": "remove_node" + }, + { + "method": "POST", + "path": "/api/v3/scan/add-friend", + "tags": [ + "统一接口", + "扫一扫" + ], + "name": "scan_add_friend" + }, + { + "method": "POST", + "path": "/api/v3/scan/extract-qr", + "tags": [ + "统一接口", + "扫一扫" + ], + "name": "extract_qr_from_image" + }, + { + "method": "GET", + "path": "/api/v3/scan/my-qr", + "tags": [ + "统一接口", + "扫一扫" + ], + "name": "show_my_qr" + }, + { + "method": "POST", + "path": "/api/v3/scan/qr-code", + "tags": [ + "统一接口", + "扫一扫" + ], + "name": "scan_qr_code" + }, + { + "method": "GET", + "path": "/api/v3/scripts", + "tags": [ + "Hook模块管理" + ], + "name": "list_scripts" + }, + { + "method": "POST", + "path": "/api/v3/scripts", + "tags": [ + "Hook模块管理" + ], + "name": "upload_script" + }, + { + "method": "GET", + "path": "/api/v3/scripts/{script_id}", + "tags": [ + "Hook模块管理" + ], + "name": "download_script" + }, + { + "method": "POST", + "path": "/api/v3/scripts/{script_id}/deploy", + "tags": [ + "Hook模块管理" + ], + "name": "deploy_script" + }, + { + "method": "GET", + "path": "/api/v3/search/wechat", + "tags": [ + "统一接口", + "搜一搜" + ], + "name": "wechat_search" + }, + { + "method": "POST", + "path": "/api/v3/settings/check-update", + "tags": [ + "统一接口", + "设置" + ], + "name": "check_update" + }, + { + "method": "POST", + "path": "/api/v3/settings/clear-cache", + "tags": [ + "统一接口", + "设置" + ], + "name": "clear_cache" + }, + { + "method": "POST", + "path": "/api/v3/settings/do-not-disturb", + "tags": [ + "统一接口", + "设置" + ], + "name": "toggle_dnd" + }, + { + "method": "POST", + "path": "/api/v3/settings/logout", + "tags": [ + "统一接口", + "设置" + ], + "name": "logout" + }, + { + "method": "POST", + "path": "/api/v3/settings/switch-account", + "tags": [ + "统一接口", + "设置" + ], + "name": "switch_account" + }, + { + "method": "POST", + "path": "/api/v3/tag/add", + "tags": [ + "统一接口", + "标签管理" + ], + "name": "add_tag" + }, + { + "method": "POST", + "path": "/api/v3/tag/create", + "tags": [ + "统一接口", + "标签管理" + ], + "name": "create_tag" + }, + { + "method": "POST", + "path": "/api/v3/tag/delete", + "tags": [ + "统一接口", + "标签管理" + ], + "name": "delete_tag" + }, + { + "method": "GET", + "path": "/api/v3/tag/list", + "tags": [ + "统一接口", + "标签管理" + ], + "name": "get_tag_list" + }, + { + "method": "POST", + "path": "/api/v3/tag/remove", + "tags": [ + "统一接口", + "标签管理" + ], + "name": "remove_tag" + }, + { + "method": "POST", + "path": "/api/v3/tag/users", + "tags": [ + "统一接口", + "标签管理" + ], + "name": "get_users_by_tag" + }, + { + "method": "POST", + "path": "/api/v3/v1/chat/completions", + "tags": [ + "AI Agent" + ], + "name": "openai_proxy" + }, + { + "method": "POST", + "path": "/api/v3/video-channel/comment", + "tags": [ + "统一接口", + "视频号" + ], + "name": "comment_video" + }, + { + "method": "POST", + "path": "/api/v3/video-channel/follow", + "tags": [ + "统一接口", + "视频号" + ], + "name": "follow_video_creator" + }, + { + "method": "POST", + "path": "/api/v3/video-channel/like", + "tags": [ + "统一接口", + "视频号" + ], + "name": "like_video" + }, + { + "method": "GET", + "path": "/api/v3/video-channel/list", + "tags": [ + "统一接口", + "视频号" + ], + "name": "get_video_list" + }, + { + "method": "POST", + "path": "/api/v3/video-channel/share", + "tags": [ + "统一接口", + "视频号" + ], + "name": "share_video" + }, + { + "method": "GET", + "path": "/api/v3/voice/apps", + "tags": [ + "语音控制", + "语音控制" + ], + "name": "get_common_apps" + }, + { + "method": "POST", + "path": "/api/v3/voice/command", + "tags": [ + "语音控制", + "语音控制" + ], + "name": "voice_command" + }, + { + "method": "POST", + "path": "/api/v3/voice/parse", + "tags": [ + "语音控制", + "语音控制" + ], + "name": "parse_command" + }, + { + "method": "POST", + "path": "/api/v3/wechat-sport/like-steps", + "tags": [ + "统一接口", + "微信运动" + ], + "name": "like_steps" + }, + { + "method": "GET", + "path": "/api/v3/wechat-sport/steps", + "tags": [ + "统一接口", + "微信运动" + ], + "name": "get_steps" + }, + { + "method": "GET", + "path": "/api/v3/wechat/account/status", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "check_account_status" + }, + { + "method": "GET", + "path": "/api/v3/wechat/actions", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "list_all_actions" + }, + { + "method": "GET", + "path": "/api/v3/wechat/channels/browse", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "browse_channels" + }, + { + "method": "POST", + "path": "/api/v3/wechat/channels/comment", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "comment_channel_video" + }, + { + "method": "POST", + "path": "/api/v3/wechat/channels/follow", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "follow_channel" + }, + { + "method": "POST", + "path": "/api/v3/wechat/channels/like", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "like_channel_video" + }, + { + "method": "POST", + "path": "/api/v3/wechat/channels/share", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "share_channel_video" + }, + { + "method": "POST", + "path": "/api/v3/wechat/channels/unfollow", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "unfollow_channel" + }, + { + "method": "GET", + "path": "/api/v3/wechat/device-info", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "get_device_info" + }, + { + "method": "POST", + "path": "/api/v3/wechat/emoji/add-custom", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "add_custom_emoji" + }, + { + "method": "POST", + "path": "/api/v3/wechat/emoji/send-custom", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "send_emoji_custom" + }, + { + "method": "POST", + "path": "/api/v3/wechat/execute", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "unified_execute" + }, + { + "method": "GET", + "path": "/api/v3/wechat/favorites", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "get_favorites" + }, + { + "method": "POST", + "path": "/api/v3/wechat/favorites/add", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "add_favorite" + }, + { + "method": "DELETE", + "path": "/api/v3/wechat/favorites/{local_id}", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "delete_favorite" + }, + { + "method": "POST", + "path": "/api/v3/wechat/float/add", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "add_to_float" + }, + { + "method": "POST", + "path": "/api/v3/wechat/float/remove", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "remove_from_float" + }, + { + "method": "GET", + "path": "/api/v3/wechat/hook/process-info", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "get_process_info" + }, + { + "method": "GET", + "path": "/api/v3/wechat/hook/status", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "get_hook_status" + }, + { + "method": "GET", + "path": "/api/v3/wechat/hook/wechat-version", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "get_wechat_version" + }, + { + "method": "POST", + "path": "/api/v3/wechat/mini-program/open", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "open_mini_program" + }, + { + "method": "GET", + "path": "/api/v3/wechat/mini-program/recent", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "get_recent_mini_programs" + }, + { + "method": "POST", + "path": "/api/v3/wechat/mini-program/share", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "share_mini_program" + }, + { + "method": "GET", + "path": "/api/v3/wechat/network-info", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "get_network_info" + }, + { + "method": "GET", + "path": "/api/v3/wechat/official-accounts", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "get_official_accounts" + }, + { + "method": "POST", + "path": "/api/v3/wechat/official-accounts/follow", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "follow_official_account" + }, + { + "method": "POST", + "path": "/api/v3/wechat/official-accounts/unfollow", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "unfollow_official_account" + }, + { + "method": "GET", + "path": "/api/v3/wechat/official-accounts/{account_id}/articles", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "get_official_account_articles" + }, + { + "method": "GET", + "path": "/api/v3/wechat/pay/balance", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "get_wallet_balance" + }, + { + "method": "POST", + "path": "/api/v3/wechat/pay/red-packet", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "send_red_packet" + }, + { + "method": "POST", + "path": "/api/v3/wechat/pay/red-packet/receive", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "receive_red_packet" + }, + { + "method": "GET", + "path": "/api/v3/wechat/pay/transactions", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "get_transaction_history" + }, + { + "method": "POST", + "path": "/api/v3/wechat/pay/transfer", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "send_transfer" + }, + { + "method": "POST", + "path": "/api/v3/wechat/pay/transfer/receive", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "receive_transfer" + }, + { + "method": "GET", + "path": "/api/v3/wechat/profile", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "get_profile" + }, + { + "method": "POST", + "path": "/api/v3/wechat/profile/avatar", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "set_avatar" + }, + { + "method": "POST", + "path": "/api/v3/wechat/profile/nickname", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "set_nickname" + }, + { + "method": "POST", + "path": "/api/v3/wechat/profile/region", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "set_region" + }, + { + "method": "POST", + "path": "/api/v3/wechat/profile/sex", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "set_sex" + }, + { + "method": "POST", + "path": "/api/v3/wechat/profile/signature", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "set_signature" + }, + { + "method": "POST", + "path": "/api/v3/wechat/profile/status", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "set_what_up" + }, + { + "method": "GET", + "path": "/api/v3/wechat/qr/group/{group_id}", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "generate_group_qr_code" + }, + { + "method": "GET", + "path": "/api/v3/wechat/qr/my", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "generate_my_qr_code" + }, + { + "method": "POST", + "path": "/api/v3/wechat/qr/scan", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "scan_qr_code" + }, + { + "method": "GET", + "path": "/api/v3/wechat/search", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "global_search" + }, + { + "method": "POST", + "path": "/api/v3/wechat/security/account-protection", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "set_account_protection" + }, + { + "method": "POST", + "path": "/api/v3/wechat/security/bind-phone", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "bind_phone" + }, + { + "method": "POST", + "path": "/api/v3/wechat/security/change-password", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "change_password" + }, + { + "method": "POST", + "path": "/api/v3/wechat/security/fingerprint", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "enable_fingerprint" + }, + { + "method": "DELETE", + "path": "/api/v3/wechat/security/login-device", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "remove_login_device" + }, + { + "method": "GET", + "path": "/api/v3/wechat/security/login-devices", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "get_login_devices" + }, + { + "method": "POST", + "path": "/api/v3/wechat/security/unbind-phone", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "unbind_phone" + }, + { + "method": "POST", + "path": "/api/v3/wechat/security/unblock", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "unblock_self" + }, + { + "method": "POST", + "path": "/api/v3/wechat/settings/chat-background", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "set_chat_background" + }, + { + "method": "POST", + "path": "/api/v3/wechat/settings/clear-history", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "clear_chat_history" + }, + { + "method": "POST", + "path": "/api/v3/wechat/settings/dnd", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "set_do_not_disturb" + }, + { + "method": "POST", + "path": "/api/v3/wechat/settings/notification", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "set_notification" + }, + { + "method": "POST", + "path": "/api/v3/wechat/settings/pin-chat", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "pin_chat" + }, + { + "method": "POST", + "path": "/api/v3/wechat/settings/privacy", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "set_privacy" + }, + { + "method": "GET", + "path": "/api/v3/wechat/storage-info", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "get_storage_info" + }, + { + "method": "GET", + "path": "/api/v3/wechat/tag/contacts/{label_id}", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "get_contacts_by_label" + }, + { + "method": "POST", + "path": "/api/v3/wechat/tag/set-contact", + "tags": [ + "微信全量操作", + "微信全量操作" + ], + "name": "set_contact_label" + }, + { + "method": "GET", + "path": "/api/v3/workbench/docs", + "tags": [], + "name": "workbench_docs" + }, + { + "method": "GET", + "path": "/api/v3/workbench/docs/{doc_id}", + "tags": [], + "name": "workbench_doc_detail" + }, + { + "method": "GET", + "path": "/api/v3/workbench/overview", + "tags": [], + "name": "workbench_overview" + }, + { + "method": "GET", + "path": "/control", + "tags": [], + "name": "control_page" + }, + { + "method": "GET", + "path": "/docs", + "tags": [], + "name": "swagger_ui_html" + }, + { + "method": "GET", + "path": "/docs/oauth2-redirect", + "tags": [], + "name": "swagger_ui_redirect" + }, + { + "method": "GET", + "path": "/health", + "tags": [], + "name": "health_check" + }, + { + "method": "GET", + "path": "/hub", + "tags": [], + "name": "hub_page" + }, + { + "method": "GET", + "path": "/install.sh", + "tags": [], + "name": "serve_install_script" + }, + { + "method": "GET", + "path": "/openapi.json", + "tags": [], + "name": "openapi" + }, + { + "method": "GET", + "path": "/pages/{page_key}", + "tags": [], + "name": "docs_page" + }, + { + "method": "GET", + "path": "/ready", + "tags": [], + "name": "ready" + }, + { + "method": "GET", + "path": "/redoc", + "tags": [], + "name": "redoc_html" + }, + { + "method": "GET", + "path": "/voice", + "tags": [], + "name": "voice_control_page" + }, + { + "method": "GET", + "path": "/wechat", + "tags": [], + "name": "wechat_control_page" + } + ] +} \ No newline at end of file diff --git a/开发文档/5、接口/05-交互图/README.md b/开发文档/5、接口/05-交互图/README.md index 94ac4d431c..46f89c7fb7 100644 --- a/开发文档/5、接口/05-交互图/README.md +++ b/开发文档/5、接口/05-交互图/README.md @@ -6,4 +6,6 @@ obsidian-color: "#00838F" | 文件 | 说明 | |------|------| -| [API架构与交互流程图.html](API架构与交互流程图.html) | 浏览器打开的 API 架构交互图 | +| [接口全量分类浏览.html](接口全量分类浏览.html) | **328 路由** 可搜索分类浏览 | +| [存客宝对接架构图.html](存客宝对接架构图.html) | 存客宝 ↔ 工作手机 SDK ↔ 设备 对接总览 | +| [API架构与交互流程图.html](API架构与交互流程图.html) | 全站 API 架构与交互流程 | diff --git a/开发文档/5、接口/05-交互图/存客宝对接架构图.html b/开发文档/5、接口/05-交互图/存客宝对接架构图.html new file mode 100644 index 0000000000..5311389155 --- /dev/null +++ b/开发文档/5、接口/05-交互图/存客宝对接架构图.html @@ -0,0 +1,142 @@ + + + + + +工作手机 SDK · 存客宝对接架构 + + + +
+

工作手机 SDK v3.0 · 存客宝对接架构

+

机擎 · 接口文档 05-交互图 | 更新 2026-05-24 | @阿桥

+ +
+

架构总览

+
+
+

存客宝 Cunkebao

+
    +
  • 场景获客 · 计划编排
  • +
  • 流量池 · 用户画像
  • +
  • 触客宝 · 移动端
  • +
  • 工作手机页 · 设备管理
  • +
+
+ PHP/TS SDK + Bearer Token +
+
+
+
+

工作手机 SDK :8899

+
REST /api/v3/* · 328 路由
+
统一 Facade message/friend/group/moments…
+
存客宝 /cunke-bao/* · 线索回写
+
Hook /hook/execute · Frida 110 actions
+
网关 OpenAI / MCP / Fleet
+
Hub WebSocket 设备长连接
+
+
+
+

Android 工作手机

+
    +
  • Agent WebSocket 客户端
  • +
  • Frida wechat_hook_v2.js
  • +
  • ADB UI 自动化兜底
  • +
  • 微信 8.0.56+
  • +
+
+
+
+ 存客宝与工作手机对接架构图 +
+
+ +
+

三条对接路径

+ + + + + + + +
路径适用方入口典型场景
① 统一 REST存客宝后端POST /api/v3/message/send发消息、加好友、群发、朋友圈
② 存客宝专用Hook / 线索闭环/api/v3/cunke-bao/*新好友→线索、通讯录批量、配置 CKB
③ AI 网关Agent / Cursor/api/v3/gateway/v1/chat/completions自然语言控机、MCP 工具调用
+
+ +
+

存客宝线索闭环

+
+微信新好友/群变动
+    │ Frida Hook 捕获
+    ▼
+设备 Agent ──POST──► /api/v3/cunke-bao/hook/friend-add
+    │                    /api/v3/cunke-bao/hook/group-change
+    ▼
+工作手机 cunke_bao_service(签名 MD5×2)
+    │
+    ▼
+存客宝 API ──► https://ckbapi.quwanzhi.com/v1/api/scenarios
+    │
+    ▼
+流量池 / 场景计划 / 触客宝展示
+    
+
+ +
+

存客宝专用接口(8 条)

+ + + + + + + + + + + + +
方法路径说明
POST/api/v3/cunke-bao/config设置 api_key、base_url、限流
GET/api/v3/cunke-bao/config查询配置(脱敏)
GET/api/v3/cunke-bao/stats上报统计
POST/api/v3/cunke-bao/report-lead手动线索上报
POST/api/v3/cunke-bao/batch-contacts批量联系人(≤500)
POST/api/v3/cunke-bao/hook/friend-addHook 新好友事件
POST/api/v3/cunke-bao/hook/group-changeHook 群变动
POST/api/v3/cunke-bao/hook/batch-eventsHook 批量事件
+
+ + +
+ + diff --git a/开发文档/5、接口/05-交互图/接口全量分类浏览.html b/开发文档/5、接口/05-交互图/接口全量分类浏览.html new file mode 100644 index 0000000000..5bd0ce360b --- /dev/null +++ b/开发文档/5、接口/05-交互图/接口全量分类浏览.html @@ -0,0 +1,50 @@ + + +工作手机 SDK · 接口全量分类浏览 (328) +
+

工作手机 SDK · 接口全量分类浏览

+

共 328 条 HTTP 路由 · 2026-05-24 自动生成 · export_api_catalog.py

+ +
+

统一接口 105

方法路径
GET/api/v3/account/restrictions
GET/api/v3/account/safety-center
GET/api/v3/account/status
GET/api/v3/anti-ban/dashboard
GET/api/v3/anti-ban/device/{device_id}
GET/api/v3/contacts
GET/api/v3/contacts/search
GET/api/v3/discover/top-stories
GET/api/v3/emoji/stickers
GET/api/v3/favorites/list
GET/api/v3/friend/info
GET/api/v3/group/list
GET/api/v3/group/members
GET/api/v3/hook/actions
GET/api/v3/hook/data/{device_id}
GET/api/v3/hook/probe/{device_id}
GET/api/v3/payment/code
GET/api/v3/payment/transactions
GET/api/v3/payment/wallet
GET/api/v3/profile/get
GET/api/v3/scan/my-qr
GET/api/v3/search/wechat
GET/api/v3/tag/list
GET/api/v3/video-channel/list
GET/api/v3/wechat-sport/steps
POST/api/v3/account/appeal-restriction
POST/api/v3/account/change-password
POST/api/v3/account/unblock
POST/api/v3/account/unblock-appeal
POST/api/v3/account/unblock-self
POST/api/v3/account/unblock-sms
POST/api/v3/auto-register/check-state
POST/api/v3/auto-register/full
POST/api/v3/auto-register/get-sim-phone
POST/api/v3/call/video
POST/api/v3/call/voice
POST/api/v3/chat/clear-history
POST/api/v3/chat/set-mute
POST/api/v3/chat/set-top
POST/api/v3/comment/reply
POST/api/v3/emoji/send
POST/api/v3/favorites/add
POST/api/v3/file/download
POST/api/v3/file/send
POST/api/v3/friend/accept
POST/api/v3/friend/add
POST/api/v3/friend/batch-add
POST/api/v3/friend/delete
POST/api/v3/friend/set-remark
POST/api/v3/group/create
POST/api/v3/group/invite
POST/api/v3/group/quit
POST/api/v3/group/remove
POST/api/v3/group/send-message
POST/api/v3/group/set-name
POST/api/v3/group/set-notice
POST/api/v3/group/set-welcome
POST/api/v3/hook/execute
POST/api/v3/location/send
POST/api/v3/location/share-realtime
POST/api/v3/mass-send
POST/api/v3/message/batch-send
POST/api/v3/message/forward
POST/api/v3/message/list
POST/api/v3/message/recall
POST/api/v3/message/send
POST/api/v3/message/send-card
POST/api/v3/message/voice
POST/api/v3/miniprogram/open
POST/api/v3/moments/comment
POST/api/v3/moments/delete
POST/api/v3/moments/like
POST/api/v3/moments/list
POST/api/v3/moments/post
POST/api/v3/moments/set-cover
POST/api/v3/moments/set-privacy
POST/api/v3/moments/share-link
POST/api/v3/official-account/follow
POST/api/v3/payment/receive
POST/api/v3/payment/receive-red-packet
POST/api/v3/payment/red-packet
POST/api/v3/payment/transfer
POST/api/v3/profile/set-avatar
POST/api/v3/profile/set-gender
POST/api/v3/profile/set-nickname
POST/api/v3/profile/set-region
POST/api/v3/profile/set-signature
POST/api/v3/scan/add-friend
POST/api/v3/scan/extract-qr
POST/api/v3/scan/qr-code
POST/api/v3/settings/check-update
POST/api/v3/settings/clear-cache
POST/api/v3/settings/do-not-disturb
POST/api/v3/settings/logout
POST/api/v3/settings/switch-account
POST/api/v3/tag/add
POST/api/v3/tag/create
POST/api/v3/tag/delete
POST/api/v3/tag/remove
POST/api/v3/tag/users
POST/api/v3/video-channel/comment
POST/api/v3/video-channel/follow
POST/api/v3/video-channel/like
POST/api/v3/video-channel/share
POST/api/v3/wechat-sport/like-steps

微信全量操作 62

方法路径
DELETE/api/v3/wechat/favorites/{local_id}
DELETE/api/v3/wechat/security/login-device
GET/api/v3/wechat/account/status
GET/api/v3/wechat/actions
GET/api/v3/wechat/channels/browse
GET/api/v3/wechat/device-info
GET/api/v3/wechat/favorites
GET/api/v3/wechat/hook/process-info
GET/api/v3/wechat/hook/status
GET/api/v3/wechat/hook/wechat-version
GET/api/v3/wechat/mini-program/recent
GET/api/v3/wechat/network-info
GET/api/v3/wechat/official-accounts
GET/api/v3/wechat/official-accounts/{account_id}/articles
GET/api/v3/wechat/pay/balance
GET/api/v3/wechat/pay/transactions
GET/api/v3/wechat/profile
GET/api/v3/wechat/qr/group/{group_id}
GET/api/v3/wechat/qr/my
GET/api/v3/wechat/search
GET/api/v3/wechat/security/login-devices
GET/api/v3/wechat/storage-info
GET/api/v3/wechat/tag/contacts/{label_id}
POST/api/v3/wechat/channels/comment
POST/api/v3/wechat/channels/follow
POST/api/v3/wechat/channels/like
POST/api/v3/wechat/channels/share
POST/api/v3/wechat/channels/unfollow
POST/api/v3/wechat/emoji/add-custom
POST/api/v3/wechat/emoji/send-custom
POST/api/v3/wechat/execute
POST/api/v3/wechat/favorites/add
POST/api/v3/wechat/float/add
POST/api/v3/wechat/float/remove
POST/api/v3/wechat/mini-program/open
POST/api/v3/wechat/mini-program/share
POST/api/v3/wechat/official-accounts/follow
POST/api/v3/wechat/official-accounts/unfollow
POST/api/v3/wechat/pay/red-packet
POST/api/v3/wechat/pay/red-packet/receive
POST/api/v3/wechat/pay/transfer
POST/api/v3/wechat/pay/transfer/receive
POST/api/v3/wechat/profile/avatar
POST/api/v3/wechat/profile/nickname
POST/api/v3/wechat/profile/region
POST/api/v3/wechat/profile/sex
POST/api/v3/wechat/profile/signature
POST/api/v3/wechat/profile/status
POST/api/v3/wechat/qr/scan
POST/api/v3/wechat/security/account-protection
POST/api/v3/wechat/security/bind-phone
POST/api/v3/wechat/security/change-password
POST/api/v3/wechat/security/fingerprint
POST/api/v3/wechat/security/unbind-phone
POST/api/v3/wechat/security/unblock
POST/api/v3/wechat/settings/chat-background
POST/api/v3/wechat/settings/clear-history
POST/api/v3/wechat/settings/dnd
POST/api/v3/wechat/settings/notification
POST/api/v3/wechat/settings/pin-chat
POST/api/v3/wechat/settings/privacy
POST/api/v3/wechat/tag/set-contact

设备管理 23

方法路径
GET/api/v3/devices
GET/api/v3/devices/{device_id}
GET/api/v3/devices/{device_id}/ai/status
GET/api/v3/devices/{device_id}/guard-events
GET/api/v3/devices/{device_id}/health
GET/api/v3/devices/{device_id}/health/events
GET/api/v3/devices/{device_id}/heartbeat
GET/api/v3/devices/{device_id}/ui-tree
GET/api/v3/guard-events/all
GET/api/v3/heartbeat/dashboard
GET/api/v3/heartbeat/events
POST/api/v3/devices/{device_id}/ai/execute
POST/api/v3/devices/{device_id}/ai/queue-task
POST/api/v3/devices/{device_id}/ai/standing-order
POST/api/v3/devices/{device_id}/ai/task
POST/api/v3/devices/{device_id}/click
POST/api/v3/devices/{device_id}/click-text
POST/api/v3/devices/{device_id}/execute
POST/api/v3/devices/{device_id}/guard-events
POST/api/v3/devices/{device_id}/heartbeat/config
POST/api/v3/devices/{device_id}/input
POST/api/v3/devices/{device_id}/screenshot
POST/api/v3/devices/{device_id}/swipe

Hook模块管理 17

方法路径
DELETE/api/v3/modules/{module_id}
GET/api/v3/devices/{device_id}/modules
GET/api/v3/devices/{device_id}/modules/{module_id}/logs
GET/api/v3/hook/events
GET/api/v3/modules
GET/api/v3/modules/{module_id}
GET/api/v3/scripts
GET/api/v3/scripts/{script_id}
POST/api/v3/devices/{device_id}/modules/reload
POST/api/v3/hook/events
POST/api/v3/modules
POST/api/v3/modules/{module_id}/disable
POST/api/v3/modules/{module_id}/enable
POST/api/v3/scripts
POST/api/v3/scripts/{script_id}/deploy
PUT/api/v3/modules/{module_id}
PUT/api/v3/modules/{module_id}/scope

ADB设备控制 15

方法路径
GET/api/v3/adb/devices
GET/api/v3/adb/devices/{serial}
GET/api/v3/adb/devices/{serial}/app/current
GET/api/v3/adb/devices/{serial}/app/list
GET/api/v3/adb/devices/{serial}/ui-tree
GET/api/v3/adb/scan
POST/api/v3/adb/devices/{serial}/app/start
POST/api/v3/adb/devices/{serial}/app/stop
POST/api/v3/adb/devices/{serial}/click
POST/api/v3/adb/devices/{serial}/click-text
POST/api/v3/adb/devices/{serial}/input
POST/api/v3/adb/devices/{serial}/key
POST/api/v3/adb/devices/{serial}/screenshot
POST/api/v3/adb/devices/{serial}/swipe
POST/api/v3/adb/scan

Frida无线管理 13

方法路径
DELETE/api/v3/frida/unregister/{device_id}
GET/api/v3/frida/actions
GET/api/v3/frida/deploy/install-script
GET/api/v3/frida/device/{device_id}
GET/api/v3/frida/devices
GET/api/v3/frida/status
POST/api/v3/frida/connect
POST/api/v3/frida/deploy/script
POST/api/v3/frida/disconnect/{device_id}
POST/api/v3/frida/discover
POST/api/v3/frida/execute
POST/api/v3/frida/execute/batch
POST/api/v3/frida/register

系统入口 12

方法路径
GET/
GET/control
GET/docs
GET/docs/oauth2-redirect
GET/health
GET/hub
GET/install.sh
GET/openapi.json
GET/ready
GET/redoc
GET/voice
GET/wechat

经验库 12

方法路径
GET/api/v3/experience/average-duration
GET/api/v3/experience/elements
GET/api/v3/experience/elements/{app}
GET/api/v3/experience/operations
GET/api/v3/experience/shortcuts
GET/api/v3/experience/shortcuts/{name}
GET/api/v3/experience/statistics
GET/api/v3/experience/success-rate
GET/api/v3/experience/suggest/coordinates
POST/api/v3/experience/operations/record
POST/api/v3/experience/shortcuts
POST/api/v3/experience/shortcuts/{name}/execute/{device_id}

外部对接网关 11

方法路径
GET/api/v3/gateway/fleet/groups
GET/api/v3/gateway/fleet/status
GET/api/v3/gateway/info
GET/api/v3/gateway/journey
GET/api/v3/gateway/journey/{device_id}
GET/api/v3/gateway/mcp/tools
GET/api/v3/gateway/v1/models
POST/api/v3/gateway/fleet/broadcast
POST/api/v3/gateway/fleet/group
POST/api/v3/gateway/mcp/call
POST/api/v3/gateway/v1/chat/completions

AI Agent 10

方法路径
GET/api/v3/agent/status/{device_id}
GET/api/v3/ai/brain/dashboard
GET/api/v3/ai/brain/skill-registry
GET/api/v3/ai/status
POST/api/v3/agent/execute
POST/api/v3/agent/stop/{device_id}
POST/api/v3/ai/brain/batch-execute
POST/api/v3/ai/brain/execute-script
POST/api/v3/ai/chat
POST/api/v3/v1/chat/completions

存客宝对接 8

方法路径
GET/api/v3/cunke-bao/config
GET/api/v3/cunke-bao/stats
POST/api/v3/cunke-bao/batch-contacts
POST/api/v3/cunke-bao/config
POST/api/v3/cunke-bao/hook/batch-events
POST/api/v3/cunke-bao/hook/friend-add
POST/api/v3/cunke-bao/hook/group-change
POST/api/v3/cunke-bao/report-lead

连接协议 7

方法路径
GET/api/v3/connection/modes
GET/api/v3/connection/modes/{device_id}
GET/api/v3/connection/protocol
GET/api/v3/connection/status
POST/api/v3/connection/simulate/heartbeat
POST/api/v3/connection/simulate/hook-event
POST/api/v3/connection/simulate/register

多服务器注册中心 6

方法路径
DELETE/api/v3/registry/nodes/{node_id}
GET/api/v3/registry/fleet/aggregate
GET/api/v3/registry/info
GET/api/v3/registry/nodes
POST/api/v3/registry/nodes/heartbeat
POST/api/v3/registry/nodes/register

设备发现 6

方法路径
GET/api/v3/discovery/last-scan
GET/api/v3/discovery/server-info
POST/api/v3/discovery/beacon/start
POST/api/v3/discovery/beacon/stop
POST/api/v3/discovery/listen-beacon
POST/api/v3/discovery/scan-lan

项目管理 6

方法路径
GET/api/v3/projects
GET/api/v3/projects/{project_id}
GET/api/v3/projects/{project_id}/devices
POST/api/v3/projects/{project_id}/broadcast
POST/api/v3/projects/{project_id}/devices/{device_id}/execute
POST/api/v3/projects/{project_id}/execute

未分类 5

方法路径
GET/api/v3/agent/download
GET/api/v3/workbench/docs
GET/api/v3/workbench/docs/{doc_id}
GET/api/v3/workbench/overview
GET/pages/{page_key}

抓包 4

方法路径
GET/api/v3/capture/data/{device_id}
GET/api/v3/capture/status/{device_id}
POST/api/v3/capture/start
POST/api/v3/capture/stop

二维码 3

方法路径
GET/api/v3/qrcode/html/{project_id}
GET/api/v3/qrcode/image/{project_id}
POST/api/v3/qrcode/generate

语音控制 3

方法路径
GET/api/v3/voice/apps
POST/api/v3/voice/command
POST/api/v3/voice/parse
+
+ \ No newline at end of file diff --git a/开发文档/5、接口/README.md b/开发文档/5、接口/README.md index b87924c1d6..6b2c7d2795 100644 --- a/开发文档/5、接口/README.md +++ b/开发文档/5、接口/README.md @@ -16,7 +16,7 @@ cssclasses: ```text 5、接口/ ├── README.md -├── images/ ← 接口类配图(暂无则留空) +├── images/ ← 接口类配图(含存客宝对接架构 PNG) ├── 01-规范与统一层/ ← 接口规范 + Facade/ChannelRouter ├── 02-业务对接/ ← 存客宝 + 外部网关 ├── 03-Hook与微信/ ← Hook 模块 API + 微信矩阵 + Frida 跳转 @@ -30,11 +30,11 @@ cssclasses: | 大类 | 入口 | |------|------| -| **01 规范与统一层** | [接口规范.md](01-规范与统一层/接口规范.md) · [通用服务交互层.md](01-规范与统一层/通用服务交互层.md) | -| **02 业务对接** | [存客宝对接规范.md](02-业务对接/存客宝对接规范.md) · [外部对接网关接口说明.md](02-业务对接/外部对接网关接口说明.md) | +| **01 规范与统一层** | [**工作手机API全量接口目录.md**](01-规范与统一层/工作手机API全量接口目录.md)(328 条) · [接口规范.md](01-规范与统一层/接口规范.md) · [通用服务交互层.md](01-规范与统一层/通用服务交互层.md) | +| **02 业务对接** | [存客宝BFF映射表](02-业务对接/存客宝BFF与工作手机SDK映射表.md) · [存客宝对接规范.md](02-业务对接/存客宝对接规范.md) · [外部对接网关接口说明.md](02-业务对接/外部对接网关接口说明.md) | | **03 Hook与微信** | [Hook模块管理接口.md](03-Hook与微信/Hook模块管理接口.md) · [微信全功能矩阵](03-Hook与微信/微信全功能矩阵_v8.0.56.md) | | **04 OpenAPI** | [openapi_v3.0.json](04-OpenAPI/openapi_v3.0.json) | -| **05 交互图** | [API架构与交互流程图.html](05-交互图/API架构与交互流程图.html) | +| **05 交互图** | [接口全量分类浏览.html](05-交互图/接口全量分类浏览.html) · [存客宝对接架构图.html](05-交互图/存客宝对接架构图.html) · [API架构与交互流程图.html](05-交互图/API架构与交互流程图.html) | **维护规范**:[机擎/阿表/开发文档结构规范/SKILL.md](../../机擎/阿表/开发文档结构规范/SKILL.md) @@ -43,3 +43,4 @@ cssclasses: ## 合并记录 - 2026-05-24:根目录 8+ 文件分层迁入 `01~05` 子目录 +- 2026-05-24:**接口全量目录** 328 路由 + OpenAPI 315 paths + 存客宝架构图 + 分类浏览 HTML + BFF 映射表 diff --git a/开发文档/5、接口/images/02-业务对接/存客宝与工作手机对接架构.png b/开发文档/5、接口/images/02-业务对接/存客宝与工作手机对接架构.png new file mode 100644 index 0000000000..f6da136c70 Binary files /dev/null and b/开发文档/5、接口/images/02-业务对接/存客宝与工作手机对接架构.png differ diff --git a/开发文档/5、接口/images/README.md b/开发文档/5、接口/images/README.md index 4810fcc22e..7a97913e71 100644 --- a/开发文档/5、接口/images/README.md +++ b/开发文档/5、接口/images/README.md @@ -1,3 +1,9 @@ # images 接口类 PNG/SVG 放此目录;按 `01-子类/` 分子文件夹(与 `2、架构/images` 规则一致)。 + +| 路径 | 说明 | +|------|------| +| [02-业务对接/存客宝与工作手机对接架构.png](02-业务对接/存客宝与工作手机对接架构.png) | 存客宝 ↔ SDK ↔ 设备 对接总览图 | + +HTML 交互版见 [05-交互图/存客宝对接架构图.html](../05-交互图/存客宝对接架构图.html)。 diff --git a/开发文档/6、测试/scripts/export_api_catalog.py b/开发文档/6、测试/scripts/export_api_catalog.py new file mode 100644 index 0000000000..a9a17f3933 --- /dev/null +++ b/开发文档/6、测试/scripts/export_api_catalog.py @@ -0,0 +1,160 @@ +#!/usr/bin/env python3 +"""从 sdk/app/main.py 扫描 FastAPI 路由,更新 routes_snapshot、OpenAPI、分类浏览 HTML。""" +from __future__ import annotations + +import json +import sys +from collections import defaultdict +from datetime import date +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[3] +SDK_APP = ROOT / "sdk" / "app" +IFACE = ROOT / "开发文档" / "5、接口" +OUT_JSON = IFACE / "04-OpenAPI" / "routes_snapshot.json" +OUT_OPENAPI = IFACE / "04-OpenAPI" / "openapi_v3.0.json" +OUT_HTML = IFACE / "05-交互图" / "接口全量分类浏览.html" + +SYSTEM_PATHS = { + "/", + "/health", + "/ready", + "/docs", + "/redoc", + "/openapi.json", + "/docs/oauth2-redirect", + "/install.sh", + "/voice", + "/wechat", + "/control", + "/hub", +} + + +def collect_routes(): + sys.path.insert(0, str(SDK_APP)) + from main import app # noqa: WPS433 + + routes = [] + for r in app.routes: + if not hasattr(r, "methods") or not hasattr(r, "path"): + continue + for m in sorted(r.methods - {"HEAD", "OPTIONS"}): + routes.append( + { + "method": m, + "path": r.path, + "tags": getattr(r, "tags", None) or [], + "name": getattr(r, "name", ""), + } + ) + seen = set() + unique = [] + for item in sorted(routes, key=lambda x: (x["path"], x["method"])): + key = (item["method"], item["path"]) + if key in seen: + continue + seen.add(key) + unique.append(item) + return unique + + +def export_openapi(): + sys.path.insert(0, str(SDK_APP)) + from main import app # noqa: WPS433 + + spec = app.openapi() + OUT_OPENAPI.write_text(json.dumps(spec, ensure_ascii=False, indent=2), encoding="utf-8") + return len(spec.get("paths", {})) + + +def render_browse_html(routes: list[dict]) -> str: + groups: dict[str, list] = defaultdict(list) + for r in routes: + if r["path"] in SYSTEM_PATHS: + groups["系统入口"].append(r) + continue + tag = (r["tags"] or ["未分类"])[0] + groups[tag].append(r) + + sections = [] + for tag in sorted(groups.keys(), key=lambda t: (-len(groups[t]), t)): + items = sorted(set((x["method"], x["path"]) for x in groups[tag])) + rows = "".join( + f"{m}{p}" for m, p in items + ) + sections.append( + f'
' + f"

{tag} {len(items)}

" + f"{rows}
方法路径
" + f"
" + ) + + today = date.today().isoformat() + count = len(routes) + return f""" + +工作手机 SDK · 接口全量分类浏览 ({count}) +
+

工作手机 SDK · 接口全量分类浏览

+

共 {count} 条 HTTP 路由 · {today} 自动生成 · export_api_catalog.py

+ +
+{''.join(sections)} +
+""" + + +def main(): + routes = collect_routes() + payload = {"count": len(routes), "routes": routes} + OUT_JSON.parent.mkdir(parents=True, exist_ok=True) + OUT_JSON.write_text(json.dumps(payload, ensure_ascii=False, indent=2), encoding="utf-8") + path_count = export_openapi() + OUT_HTML.write_text(render_browse_html(routes), encoding="utf-8") + print(f"routes_snapshot: {len(routes)} -> {OUT_JSON}") + print(f"openapi paths: {path_count} -> {OUT_OPENAPI}") + print(f"browse html -> {OUT_HTML}") + + +if __name__ == "__main__": + main() diff --git a/开发文档/6、测试/scripts/workphone_bff_smoke.sh b/开发文档/6、测试/scripts/workphone_bff_smoke.sh new file mode 100755 index 0000000000..9020c8ecd4 --- /dev/null +++ b/开发文档/6、测试/scripts/workphone_bff_smoke.sh @@ -0,0 +1,31 @@ +#!/usr/bin/env bash +# 工作手机 SDK + 存客宝 BFF 联调冒烟(本地) +# 用法:WORKPHONE_SDK_URL=http://127.0.0.1:8899 ./workphone_bff_smoke.sh [device_id] + +set -euo pipefail +SDK_URL="${WORKPHONE_SDK_URL:-http://127.0.0.1:8899}" +DEVICE_ID="${1:-}" + +echo "SDK: $SDK_URL" + +health=$(curl -s -m 5 "${SDK_URL}/health") +echo "health: $health" + +if [[ -z "$DEVICE_ID" ]]; then + DEVICE_ID=$(python3 -c "import json,sys; d=json.loads(sys.argv[1]); print((d.get('device_ids') or [''])[0])" "$health") +fi + +if [[ -z "$DEVICE_ID" ]]; then + echo "无在线设备,跳过 device 级测试" + exit 0 +fi + +echo "device_id: $DEVICE_ID" + +curl -s -m 5 "${SDK_URL}/api/v3/workbench/overview" | python3 -m json.tool | head -15 +curl -s -m 5 "${SDK_URL}/api/v3/devices/${DEVICE_ID}/ai/status" | python3 -m json.tool +curl -s -m 5 -X POST "${SDK_URL}/api/v3/devices/${DEVICE_ID}/ai/task" \ + -H 'Content-Type: application/json' \ + -d '{"instruction":"冒烟测试:检查微信是否在前台","priority":9}' | python3 -m json.tool + +echo "OK — SDK 联调冒烟通过" diff --git a/开发文档/9、手册/02-操作指南/工作手机·一键接入与存客宝对接操作手册.md b/开发文档/9、手册/02-操作指南/工作手机·一键接入与存客宝对接操作手册.md index d083050150..f075b967ab 100644 --- a/开发文档/9、手册/02-操作指南/工作手机·一键接入与存客宝对接操作手册.md +++ b/开发文档/9、手册/02-操作指南/工作手机·一键接入与存客宝对接操作手册.md @@ -1,7 +1,9 @@ # 工作手机 · 一键接入与存客宝对接操作手册 -> **总览请先读**:[工作手机·五图总览与使用手册.md](工作手机·五图总览与使用手册.md)(v2.1 · 补全包已并入) -> **版本**:v4.0 (Frida 主控通道版) +> **总览请先读**:[工作手机·五图总览与使用手册.md](../工作手机·五图总览与使用手册.md)(v2.3) +> **接口全量目录**:[5、接口/01-规范与统一层/工作手机API全量接口目录.md](../../5、接口/01-规范与统一层/工作手机API全量接口目录.md)(328 路由) +> **BFF 映射**:[5、接口/02-业务对接/存客宝BFF与工作手机SDK映射表.md](../../5、接口/02-业务对接/存客宝BFF与工作手机SDK映射表.md) +> **版本**:v4.1 (Frida 主控 + 接口文档闭环) > **目标**:实现从“手机插上 Type-C”到“存客宝代码直接控制手机”的端到端闭环,主控通道强制走 **Frida Hook**(稳定、快速、无 UI 干扰),失败自动降级到 ADB/无障碍。 > **文档位置**:`开发文档/9、手册/工作手机·一键接入与存客宝对接操作手册.md` diff --git a/开发文档/9、手册/工作手机·五图总览与使用手册.md b/开发文档/9、手册/工作手机·五图总览与使用手册.md index 891e0bf35d..1ef0aaf8ea 100644 --- a/开发文档/9、手册/工作手机·五图总览与使用手册.md +++ b/开发文档/9、手册/工作手机·五图总览与使用手册.md @@ -296,12 +296,14 @@ python3 开发文档/6、测试/scripts/wireless_frida_wechat_batch_verify.py | 命令速查 | [SDK操作手册.md](02-操作指南/SDK操作手册.md) | | E2E 验收 | [微信消息E2E验证指南.md](03-验证/微信消息E2E验证指南.md) | | 存客宝对接 | [工作手机·一键接入与存客宝对接操作手册.md](02-操作指南/工作手机·一键接入与存客宝对接操作手册.md) | +| **接口全量目录** | [5、接口/01-规范与统一层/工作手机API全量接口目录.md](../5、接口/01-规范与统一层/工作手机API全量接口目录.md)(328 路由) | +| **存客宝 BFF 映射** | [5、接口/02-业务对接/存客宝BFF与工作手机SDK映射表.md](../5、接口/02-业务对接/存客宝BFF与工作手机SDK映射表.md) | | 接口 OpenAPI | [5、接口/04-OpenAPI/openapi_v3.0.json](../5、接口/04-OpenAPI/openapi_v3.0.json) | | 进度 | [开发进度总表.md](../10、项目管理/开发进度总表.md) | 以下文档 **已并入本章**,保留文件仅为旧链接锚点,勿再扩写: -- [微信Frida_API契约.md](../5、接口/微信Frida_API契约.md) → 见 §3.1 +- [微信Frida_API契约.md](../5、接口/03-Hook与微信/微信Frida_API契约.md) → 见 §3.1 - [微信Frida无线部署与验证说明.md](../8、部署/02-设备Hook/微信Frida无线部署与验证说明.md) → 见 §八 --- @@ -310,7 +312,7 @@ python3 开发文档/6、测试/scripts/wireless_frida_wechat_batch_verify.py | 日期 | 版本 | 说明 | |------|------|------| -| 2026-05-24 | **v2.2** | **根目录补全包目录移除**;`wechat_hook_bridge.js` 收编 `sdk/agent/hook/`;CodeGraph 索引初始化 | +| 2026-05-24 | **v2.3** | **接口全量目录 328 条** + 存客宝 BFF 映射 + 对接架构图;OpenAPI 315 paths 重导出 | | 2026-05-24 | **v2.1** | 附图本地化 fig06~09;机擎/开发文档总入口对齐 | | 2026-05-24 | **v2.0** | **补全包 + 微信Frida 补全包全文并入**;九模块路径对齐 `sdk/`;RPC 兼容 §七;无线部署 §八;架构/真机附图;去重原型 API | | 2026-05-24 | v1.2 | 五图为主、正文只补 API/命令/数字 |