扫码小鱼talk绑定会议

功能说明

小鱼talk会中做了录制，结束后，用户可扫描小鱼talk 上的二维码，绑定会议，然后通过会议 id查询转写、纪要。

默认接口请求频率限制：20次/秒。

实现方法

REST URL

POST /api/rest/external/v1/ai/talk/bind?enterpriseId=xxx

请求参数说明:

参数	参数类型	参数位置	必须	默认值	说明	初始平台
enterpriseId	String	Query	是	无	企业ID，通过管理平台-云视讯API获得	5.2-20260626
signature	String	Query	签名鉴权1.0（旧）：是签名鉴权2.0：否	无	API签名，参考签名鉴权	5.2-20260626
shortCode	String	body	是	无	小鱼Talk扫码获取的短码	5.2-20260626
externalUserId	String	body	否	无	三方用户ID（与phone二选一，不可同时传），最大长度 50	5.2-20260626
phone	String	body	否	无	用户手机号（与externalUserId二选一，不可同时传），最大长度 128	5.2-20260626

示例代码

请求示例:

{                                                                                                                                                                                                                  
    "shortCode": "abc123def456",                                                                                                                                                                                     
    "externalUserId": "user_001"                                                                                                                                                                                     
 }

结果示例:

{                                                                                                                                                                                                                  
    "meetingId": "abc123def456"                                                                                                                                                                                                                                                                                                                                                                         
 }

请求成功返回http状态码200

请求失败结果示例:

{
    "developerMessage": "ErrorStatus: INVALID_CLOUD_MEETING_NUMBER enterpriseId is INVALID",
    "userMessage": "invalid cloud meeting number",
    "errorCode": 4117,
    "moreInfo": "http://www.com.ainemo.com/errors/4117"
}

错误码

以下仅列出该接口业务逻辑错误码，其他错误码见小鱼RESTAPI错误码

HTTP 状态码	对外 errorCode	userMessage	developerMessage	触发条件	集成方处理建议
400	1001	invalid.parameter	request body cannot be null	请求体为空	修正请求体后重试
400	1001	invalid.parameter	error param:shortCode not allow null / error param:shortCode empty string	shortCode 为空	补充 shortCode 后重试
400	1001	invalid.parameter	shortCode length >128	shortCode 长度超过 128 位	修正 shortCode 后重试
400	1001	invalid.parameter	externalUserId length >50	externalUserId 长度超过 50 位	修正 externalUserId 后重试
400	1001	invalid.parameter	invalid externalUserId, pattern:[0-9a-zA-Z_-]{0,50}	externalUserId 格式非法，仅允许字母、数字、下划线、短横线，最长 50 位	修正 externalUserId 后重试
400	1001	invalid.parameter	phone length >128	phone 长度超过 128 位	修正 phone 后重试
400	1001	invalid.parameter	externalUserId and phone cannot be set at the same time	externalUserId 与 phone 同时传入	二选一传参后重试
400	1001	invalid.parameter	externalUserId or phone must be set	externalUserId 与 phone 同时为空	补充其中一个参数后重试
400	40060053	invalid.shortcode	shortcode not found or expired / Invalid Shortcode	shortCode 不存在、伪造、已清理、已过期	重新扫码获取新 shortCode，不建议原码重试
403	40060054	shortcode.expired	Shortcode Expired	上游明确返回短码过期，当前代码实际不可达	后续上游拆分语义再启用，处理方式为重新扫码
400	40060052	user not exists	phone not exist:{phone}	手机号不属于当前企业或不存在	更换企业内有效手机号，勿重试同一手机号
400	6551001	invalid.parameter	VOD 上游返回具体非法原因	VOD meetingAuthor 校验失败：meetingId 为空或 userId ≤ 0	服务端 / 数据侧排查，业务链路正常不应出现
400	6553911	vod.save.failed	VOD 上游返回异常信息	VOD setMeetingVodAuthor 返回 null	可稍后重试一次，持续失败排查 VOD 服务
400	6553912	vod.save.already.bound	VOD 上游返回异常信息	会议录制文件已绑定作者，含重复绑定、跨用户绑定冲突	无需重试，提示用户会议已绑定
500	655700	internal.error	VOD 上游异常信息 /internal.error	VOD 未捕获运行时异常	可稍后重试，持续失败由服务端排查

2026-05-14 17:55:26

导出PDF文档