调用Vimeo API进行TUS上传时请求参数被忽略该如何解决？

问题根因及排查方案 #

你遇到的问题90%以上是缺少API版本声明请求头导致的，Vimeo的tus上传特性仅在3.4及以上版本的API中支持，不指定版本的请求会默认调用旧版接口，自动fallback到传统表单上传模式，所以不会返回预期的upload对象。
你可以按照以下顺序排查：

• 第一步：在请求头中添加版本声明字段
  新增请求头Accept: application/vnd.vimeo.*+json;version=3.4，Vimeo要求所有接口请求必须明确声明API版本，否则会使用最低兼容版本的旧逻辑，忽略tus相关的参数配置。
• 第二步：校验上传文件大小的准确性
  确认请求体中upload.size的数值和你要上传的视频文件的实际字节数完全一致，数值错误也会导致接口判定参数非法，自动切换为旧上传模式。
• 第三步：排查请求体序列化问题
  确认发送请求时JSON请求体没有被额外转义、没有字段缺失，你当前给出的请求体结构本身是符合要求的。

以上配置全部调整正确后如果还是无法得到预期的tus上传响应，才有可能是Vimeo侧接口故障，你可以联系Vimeo技术支持提交ticket排查。

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