使用LinkedIn Videos API获取部分视频缩略图时遇500内部服务器错误

调用LinkedIn Videos API获取视频缩略图时返回500 Internal Server Error，涉事视频为上周发布的MP4格式，媒体URN为urn:li:video:D4D05AQEuZHjf3NPyDA（URL编码后为urn%3Ali%3Avideo%3AD4D05AQEuZHjf3NPyDA）。请求详情：

GET https://api.linkedin.com/rest/videos/urn%3Ali%3Avideo%3AD4D05AQEuZHjf3NPyDA

错误响应：

{
    "message": "Internal Server Error",
    "status": 500
}

测试发现，无论是MP4/MOV格式，还是个人/企业账号下的视频，均存在部分可正常获取、部分失败的情况。

• 校验API权限与请求合法性
  确认请求携带的访问令牌拥有对应权限：个人视频需w_member_social或r_member_social，企业账号视频需r_organization_social或w_organization_social；同时检查请求头中的LinkedIn-Version是否为当前支持的版本（如202405），避免因版本兼容问题导致错误。

• 验证视频本身状态
  登录LinkedIn网页端，找到对应视频确认缩略图是否正常显示：

  • 若网页端缩略图也无法加载，说明视频在LinkedIn后台的处理流程存在异常，等待平台自动修复或重新上传视频；
  • 若网页端显示正常，则问题出在API服务侧，需进一步排查。

• 临时错误重试
  500错误属于服务器内部临时故障，可实现指数退避重试机制（如间隔1分钟、3分钟、5分钟依次重试），多数临时波动会在重试后恢复。

• 提交官方支持工单
  若多次重试仍无法解决，收集以下信息提交至LinkedIn开发者支持：

  • 完整的请求头（隐去敏感的Authorization令牌）
  • 错误响应的完整内容
  • 视频的原始URN
  • 网页端视频的访问链接
  • 账号类型（个人/企业）及视频格式

内容的提问来源于stack exchange，提问作者Carina