TikTok Post Video API上传视频点击通知报Something went wrong问题
该问题的排查方向与修复方案
接口返回share_id仅代表视频文件成功上传到TikTok的临时中转存储,不代表后续素材校验、投递流程正常,点击通知弹出通用错误基本是以下几类原因,按排查优先级排序:
- 应用权限/状态异常
如果你用的是还没提交上线的测试应用,只有开发者后台手动添加的测试白名单账号能正常走完发布流程,非白名单账号哪怕拿到合法access_token、上传成功拿到share_id,点击通知时必然报这个错。另外需要确认你申请的视频上传权限是否处于生效状态,测试阶段的权限不会对所有账号开放,这个限制和账号所在区域、手机IP无关,切区域测试没有意义。 - 视频素材不符合规范
TikTok收到上传的视频后会做静默校验,不会把校验错误通过接口返回:要求视频必须是H.264编码、AAC音频的MP4格式,不能带DRM保护,文件大小不能超过500M,不能带其他平台的硬水印、异常元数据标记。很多人传HEVC编码的视频、或者用剪辑软件导出时带了特殊编码标记,都会出现接口全返回成功、但点通知进不去编辑页的问题。你可以先拿一段手机原生相机直出的10秒1080P无剪辑MP4做测试,先排除素材问题。 - 上传请求参数不全
你当前调用的上传接口如果只传了open_id、access_token和视频文件,大概率会触发这个静默失败:该接口要求必须同步传video_size(视频文件字节数)、file_name(带.mp4后缀的文件名)参数,分片上传的话还要传正确的chunk_size、chunk_index参数;另外上传视频时的Content-Type必须设为video/mp4,传成通用二进制流application/octet-stream也会导致后续素材解析失败。 - 客户端/账号环境异常
不要用修改版、虚拟环境里运行的TikTok客户端,必须安装对应区域官方应用商店下载的正式版本;同时确认测试用的TikTok账号没有处于风控、限流、待完成手机号/邮箱验证的状态,账号有异常标记时,第三方应用投递的视频无法进入编辑发布流程。
我之前对接时踩过完全一样的坑:最开始一直传HEVC编码的4K视频,所有接口返回全正常,点通知就报通用错误,把视频转成H.264+AAC编码的1080P规格、把测试账号加到开发者后台白名单之后,问题直接解决。
内容的提问来源于stack exchange,提问作者Shameel Uddin
相关产品推荐
相关产品推荐

