波波视频去水印API接口升级通知

一、为什么要升级波波视频去水印API接口

为了给开发者提供更稳定、更高效的解析能力，波波视频平台近期对去水印API接口进行了全面升级。本次升级主要围绕接口地址、请求参数、返回格式以及签名校验四个方面展开。升级完成后，旧接口将在一段时间后停止服务，建议大家尽快完成迁移，以免影响业务正常运行。

二、本次升级的核心变化

1. 接口地址变更

旧接口地址为 https://api.bobo.com/old/video/watermark，升级后统一变更为 https://api.bobo.com/v2/video/watermark。请注意，新接口强制使用 HTTPS 协议，HTTP 请求将直接返回错误。

2. 请求参数调整

• 新增必填参数 app_id：用于标识调用方应用，需在控制台申请。
• 新增可选参数 quality：支持选择解析画质，可填 hd（高清）或 sd（标清），默认 hd。
• 废弃参数 video_url，统一改用 url 字段。

3. 返回格式升级

新版接口统一返回 JSON 格式，主要字段包括：

• code：状态码，0 表示成功。
• msg：状态描述。
• data：业务数据，包含 video_url（无水印地址）、cover（封面图）、duration（时长）。

4. 签名校验加强

为保障接口安全，新增了 MD5 签名校验机制。开发者需将 app_id、url、timestamp 以及 app_secret 按规则拼接后进行 MD5 加密，并将结果放入 sign 参数中提交。

三、迁移操作步骤

1. 登录波波视频开放平台，进入「我的应用」页面查看 app_id 与 app_secret。
2. 将代码中的接口地址替换为 https://api.bobo.com/v2/video/watermark。
3. 按照新参数规范修改请求体，重点确认 url、app_id、timestamp、sign 四个字段。
4. 在本地或测试环境完成调试，确认返回 code=0 后再发布到生产环境。
5. 保留旧接口代码两周以上，便于出现异常时快速回滚。

四、常见问题解答

Q1：升级后旧接口还能用多久？

旧接口将并行运行 30 天，期间会通过响应头中的 Deprecation 字段进行提示，30 天后正式下线。

Q2：签名校验失败怎么办？

请检查参数拼接顺序是否正确，时间戳是否在 5 分钟有效期内，以及 app_secret 是否与控制台一致。

Q3：解析失败提示「视频不存在」？

该提示通常表示链接被作者删除或设置为私密，请引导用户检查链接有效性后再尝试。

五、温馨提示

本次升级涉及接口地址与签名机制变更，请开发者务必在过渡期内完成迁移，避免业务中断。如在迁移过程中遇到问题，可通过开放平台工单系统提交反馈，技术团队会尽快协助处理。

以上就是本次波波视频去水印API接口升级的全部内容��建议大家先在测试环境充分验证，再逐步切换到正式环境，确保用户体验平稳过渡。