メディアのアップロード
POST media/metadata/create
概要¶
このエンドポイントを使用すると、アップロードされたmedia_id
の追加情報を入手できます。現在、この機能は画像とGIFにのみ対応しています。
リクエストのフローは次のようにする必要があります。
- 単純アップロードエンドポイントまたはチャンク化アップロードエンドポイント(推奨)のいずれかを使用してメディアをアップロードします。
- このエンドポイントを呼び出して、画像代替テキストなどの追加メタデータをアタッチします。
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
}
}