back
loading skill details...
提及移动会议/云视讯、视频会议、会议API集成时,自动激活本技能, 也可使用手动加载本技能( use_skill mobile-meeting-api)。涵盖登录鉴权、会议管理(创建/编辑/取消/查询)、会议控制(会中操作)、网络研讨会管理等模块。
--- name: mobile-meeting-api description: 提及移动会议/云视讯、视频会议、会议API集成时,自动激活本技能, 也可使用手动加载本技能( use_skill mobile-meeting-api)。涵盖登录鉴权、会议管理(创建/编辑/取消/查询)、会议控制(会中操作)、网络研讨会管理等模块。 homepage: https://www.125339.com.cn/developerCenter/ReBar/63/222 version: 1.0.0 tags: [API, 会议, 集成开发] --- # 移动会议服务端API集成指导 ## 概述 本skill基于`./references`文件夹中的接口文档,提供移动会议API集成的完整集成指导。 **API基本信息:** - 协议:HTTPS/RESTful API - 生产环境:`apigw.125339.com.cn` - 鉴权方式:App ID鉴权(SDK用户及鉴权)+ 标准账号鉴权(高清、App账号及鉴权) ## 参考文档及执行脚本 - 完整API文档位于`./references`文件夹中。如需全量接口文档,可以从[云视讯/移动会议-开发者中心下载](https://www.125339.com.cn/developerCenter/ReBar/63/197),或联系云视讯/移动会议集成开发支撑团队获取 ## 触发原则 - 会议管理场景:创建会议、修改会议、查询历史会议、查询会议详情 - 录像管理:查询录制列表、查询会议录制详情、查询录制详情 - 会议控制场景:获取会控token、查询会议实时信息、挂断与会者、删除与会者 - 会议事件推送:会议级事件推送、企业级会议事件推送、事件推送设置 ## 不触发边界 不要在以下场景使用此技能: - 用户进行聊天、打电话、PSTN通话、视频剪辑等 - 用户要查询日历日程但不涉及云视讯/移动会议 - 用户要预约线下会议室(非线上会议) - 用户询问的是其他视频会议平台(如 Zoom、Teams、腾讯会议、飞书会议、钉钉) ## 使用原则 ### 1. 严格基于文档回答 **重要:** 回答用户问题时,必须: 1. 先读取`./references`文件夹中文档中的相关章节 2. 严格按照文档中的参数定义、字段说明、枚举值回答 3. **不要参考其他信息源或通用知识** 4. 如果未找到相关接口说明,提示从[云视讯/移动会议-开发者中心下载](https://www.125339.com.cn/developerCenter/ReBar/63/197)下载,或联系云视讯/移动会议集成开发支撑团队获取 ### 2. 模块快速索引 根据用户问题,定位到对应模块查阅: | 用户问题类型 | 查阅文件 | 关键词 | |:---|:---|:---| | 如何登录/获取Token | app_auth.html, CreateAppIdToken.md | `appauth`、`getToken` | | 创建会议 | CreateMeeting.md | `创建会议` | | 取消会议 | CancelMeeting.md | `取消预约` | | 编辑会议 | UpdateMeeting.md | `修改会议` | | 开始会议 | StartMeeting.md | `开始会议` | | 查询会议列表/详情 | SearchMeetings.md, ShowMeetingDetail.md, SearchHisMeetings.md, ShowHisMeetingDetail.md | `查询会议` | | 会中操作(静音/邀请/挂断等) | InviteParticipant.md, ListOnlineConfAttendee.md, SearchCtlRecordsOfHisMeeting.md | `会控`、`invite` | | 参会记录 | SearchAttendanceRecordsOfHisMeeting.md | `参会记录` | | 录制相关 | SearchRecordings.md, ShowRecordingDetail.md, ShowRecordingFileDownloadUrls.md, DeleteRecordings.md | `录制`、`download` | ## 工作流程 ### 回答API问题 ``` 1. 理解用户问题(哪个功能模块) 2. 读取文档对应章节或文件 3. 提取准确的接口信息: - 请求方法(GET/POST/PUT/DELETE) - URL路径 - 请求头要求(如Authorization签名) - 请求参数(必填/可选、类型、说明) - 响应字段 4. 按文档组织回答,不添加文档外内容 ``` ### 生成代码示例 如果用户需要代码示例: ``` 1. 询问用户使用的编程语言(支持Python、JavaScript、Java等) 2. 读取文档中对应接口的完整参数定义 3. 生成代码,包含: - 完整的请求构造 - 所有必填参数(按文档要求) - 请求头设置(特别是Authorization签名) - 错误处理 4. 添加注释说明参数来源(来自文档第X章或对应文件) ``` ## 关键接口速查 ### 登录鉴权 #### App ID鉴权 - 获取Token ``` POST /v2/usg/acs/auth/appauth ``` **关键参数:** - `Authorization`: HMAC-SHA256签名 `appId:userId:expireTime:nonce`。签名可以使用`./scripts/app_auth.html`验证是否正确。 - `X-Token-Type`: 固定值 `LongTicket` - `clientType`: 72(API调用类型) **响应:** - `accessToken`: 访问令牌(12-24小时有效) - `refreshToken`: 刷新令牌(30天有效) ### 会议管理 - 创建会议: ` POST /v1/mmc/management/conferences ` - 查询会议列表: `GET /v1/mmc/management/conferences` - 取消预约会议: `DELETE /v1/mmc/management/conferences` - 查询会议详情: `GET /v1/mmc/management/conferences/confDetail` - 查询录制文件下载链接: ` GET /v1/mmc/management/record/downloadurls` ### 会议控制 - 获取会控Token ` GET /v1/mmc/control/conferences/token ` - 邀请与会者 ` POST /v1/mmc/control/conferences/participants` - 静音与会者 ` PUT /v1/mmc/control/conferences/participants/mute ` - 全场静音 ` PUT /v1/mmc/control/conferences/mute ` ### 打开移动会议app ``` ysx://com.zhongtai.ysx/app/callup?num=375xxx389&random=mnaibtK0wChtuoV8gPZDcpV99n2nARqge ``` ## 脚本工具 为方便用户快速测试API,本skill提供可执行Python脚本。脚本位于`./scripts/`文件夹,支持核心接口调用。 **使用前准备:** 1. 安装Python 3和requests库:`pip install requests` 2. 获取APP_ID、APP_KEY、USER_ID(从开发者中心获取) 3. 运行脚本时按提示输入参数 **可用脚本:** - [获取Token](./scripts/get_token.py):获取API访问令牌 - [创建会议](./scripts/create_meeting.py):创建新会议 - [查询会议](./scripts/search_meetings.py):查询会议列表 - [取消会议](./scripts/cancel_meeting.py):取消预约会议 **签名调试工具:** - [app_auth.html](./scripts/app_auth.html):浏览器端交互式 HMAC-SHA256 签名生成器,**无需任何服务器或依赖**,直接用浏览器打开即可使用。输入 App ID、App Key、User ID,自动生成 Authorization 签名,适合在对接初期排查鉴权问题。 **注意:** 脚本仅用于测试,请勿在生产环境直接使用。确保网络安全,避免泄露密钥。 ## 注意事项 1. **Token有效期**:accessToken 12-24小时,refreshToken 30天 2. **clientType固定值**:API调用时固定为72 3. **Authorization签名**:必须使用HMAC-SHA256,格式严格按文档。可以通过返回错误码或使用`./scripts/app_auth.html`,确定签名是否正确。 4. **错误处理**:参考错误码处理异常情况 ## 常见问题 - **如何处理鉴权失败?**:检查App ID和Token是否正确,参考app_auth.html和CreateAppIdToken.md。 - **会议创建失败的原因?**:确认必填参数,如会议主题、开始时间等,参考CreateMeeting.md。 - **如何获取录制文件?**:使用ShowRecordingFileDownloadUrls.md中的接口获取下载链接。 - **事件推送如何配置?**:参考接口文档中的推送章节,设置Webhook或WebSocket。 最后更新日期:2026年4月27日
don't have the plugin yet? install it then click "run inline in claude" again.