使用Vimeo PHP-SDK获取域名白名单限制的私有视频问题咨询
Vimeo域名白名单私有视频拉取异常解决方案
错误根因
你当前使用的仅携带public scope的access token仅能访问公开无额外访问限制的Vimeo视频,你遇到的video not found报错是预期的权限拦截结果:域名白名单属于视频私有访问限制范畴,不在public scope的授权范围内,因此API无法返回对应视频信息。
具体修复操作
- 调整access token的授权scope:生成access token时需要额外添加
video_files、privatescope,可根据实际业务需要补充其他视频相关权限scope。如果该私有视频属于你的合作客户所有,需要走OAuth 2.0授权流程让客户完成账号授权,获取对其私有视频资源的访问权限;如果是你自有账号下的视频,直接在Vimeo开发者后台生成携带对应scope的个人access token即可。 - 后端持有效授权token发起请求:只要你的后端持有上述合法的、具备对应视频访问权限的access token,就可以继续在后端静默拉取视频信息,无需前端用户参与授权操作。
- 完成域名白名单配置:拉取到视频播放地址后,需要确保前端播放该视频的页面域名已经被添加到视频所属账号的允许播放域名白名单内,否则即使拉取到播放地址,前端播放时仍会触发Vimeo的域名校验拦截,无法正常播放。
疑问回复
- 是否需要发起认证请求?是,你需要重新申请携带私有视频访问权限scope的access token,第三方客户的视频需要客户完成授权后才能拿到有效token。
- 是否意味着前端用户必须登录Vimeo,无法在后端静默拉取?不是,只要后端持有的access token权限足够,全程可以在后端静默拉取,前端用户完全无感知,不需要登录任何Vimeo账号。
内容的提问来源于stack exchange,提问作者caevv
相关产品推荐
相关产品推荐

