GET media/upload (STATUS)

概述

STATUS 命令用于定期为媒体处理操作更新投票。STATUS 命令响应返回 succeeded 后,您可以继续下一步,通常是使用 media_id 创建推文。

请求

应该是带有 url 参数的 HTTP GET 请求。

注意: 此端点的域为 upload.twitter.com

响应

响应正文需包含 processing_info 字段,该字段提供有关当前媒体处理操作状态的信息。包含过渡流程的 state 字段:“pending”(待处理)-> “in_progress”(处理中)-> [“failed” | “succeeded”](失败 | 成功)。在状态字段设置为“succeeded”(成功)之前,不能使用 media_id 创建推文或其他实体。

资源信息

响应格式 JSON
是否需要认证? 是(仅限用户情景)
是否存在速率限制?

参数

名称 必填 说明 默认值 示例
command 必填 必须设置为 STATUS(区分大小写)。
media_id 必填 media_id 已从 INIT 命令返回。

示例请求

GET https://upload.twitter.com/1.1/media/upload.json?command=STATUS&media_id=710511363345354753

示例结果

// Example of an in_progress response:

{
  "media_id":710511363345354753,
  "media_id_string":"710511363345354753",
  "expires_after_secs":3595,
  "processing_info":{
    "state":"in_progress", // state transition flow is pending -> in_progress -> [failed|succeeded]
    "check_after_secs":10, // check for the update after 10 seconds
    "progress_percent":8 // Optional [0-100] int value. Please don't use it as a replacement of "state" field.
  }
}

// Example of a failed response:

{
  "media_id":710511363345354753,
  "media_id_string":"710511363345354753",
  "processing_info":{
    "state":"failed",
    "progress_percent":12,
    "error":{
      "code":1,
      "name":"InvalidMedia",
      "message":"Unsupported video format"
    }
  }
}

// Example of a succeeded response:

{
  "media_id":710511363345354753,
  "media_id_string":"710511363345354753",
  "expires_after_secs":3593,
  "video":{
    "video_type":"video/mp4"
  },
  "processing_info":{
    "state":"succeeded",
    "progress_percent":100,
  }
}

Was this document helpful?

感谢

谢谢你的反馈。我们真的很高兴能帮上忙!

Thank you for the feedback. How could we improve this document?

Thank you for the feedback. Your comments will help us improve our documents in the future.