POST media/metadata/create

概要

このエンドポイントを使用すると、アップロードされたmedia_idの追加情報を入手できます。現在、この機能は画像とGIFにのみ対応しています。

リクエストのフローは次のようにする必要があります。

  1. 単純アップロードエンドポイントまたはチャンク化アップロードエンドポイント(推奨)のいずれかを使用してメディアをアップロードします。
  2. このエンドポイントを呼び出して、画像代替テキストなどの追加メタデータをアタッチします。
  3. media_id(s)がアタッチされたツイートを作成します。

リクエスト

リクエストはJSONでコンテンツを記述したHTTP POSTで、コンテンツのタイプがapplication/json; charset=UTF-8またはtext/plain; charset=UTF-8である必要があります。

注: このエンドポイントのドメインはupload.twitter.comです

応答

成功した場合の応答はHTTP 2xxを返します。

リソースURL

https://upload.twitter.com/1.1/media/metadata/create.json

リソース情報

応答形式 JSON
認証の要否 要(ユーザーのコンテキストに限る)
レート制限 あり

リクエストの例

POST https://upload.twitter.com/1.1/media/metadata/create.json

{
  "media_id":"692797692624265216",
  // image alt text metadata
  "alt_text": {
    "text":"dancing cat" // Must be <= 420 chars
  }
}