POST media/upload (INIT)

概要¶

INITコマンドリクエストを使用すると、ファイルのアップロードセッションを開始できます。すべての後続リクエストの実行に使用する必要があるmedia_idを返します。INITコマンドから正常な応答が得られたら、次の手順はAPPENDコマンドです。

メディアファイルに関する制限事項や要件については、「メディアのアップロードガイド」を参照してください。

リクエスト¶

リクエストはmultipart/form-dataPOST形式またはapplication/x-www-form-urlencodedPOST形式である必要があります。

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

応答¶

応答では、media_id（64ビットの整数値）フィールドおよびmedia_id_string（文字列）フィールドにメディア識別子が返されます。JavaScript、および長い整数値を正確に記述できないその他の言語の場合は、API応答で返されるmedia_id_stringを使用します。

expires_after_secs秒が経過するまでにファイル全体をアップロードする必要があります。

additional_ownersフィールドでは、メディアをユーザーAとしてアップロードしてから、ユーザーBとしてツイート作成に使用できます。

リソースURL¶

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

リソース情報¶

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

パラメータ¶

名前	要否	説明	デフォルト値	例
command	必須	`INIT`に設定する必要があります（大文字、小文字の区別あり）。
total_bytes	必須	アップロードされるメディアのサイズ（バイト単位）です。
media_type	必須	アップロードされるメディアのMIMEタイプです。		`video/mp4`
media_category	場合による	メディアのユースケースを識別する文字列列挙値です。この識別子を使用すると、ユースケースに固有の制約（ファイルサイズ、動画の長さなど）を適用したり、高度な機能を有効化したりできます。
additional_owners	任意	返された`media_id`をツイートまたはカードで使用できる、追加オーナーとして設定されるユーザーIDのカンマ区切りリストです。最大100の追加オーナーを指定できます。

リクエストの例¶

POST https://upload.twitter.com/1.1/media/upload.json?command=INIT&total_bytes=10240&media_type=image/jpeg

結果の例¶

{
  "media_id": 710511363345354753,
  "media_id_string": "710511363345354753",
  "size": 11065,
  "expires_after_secs": 86400,
  "image": {
    "image_type": "image/jpeg",
    "w": 800,
    "h": 320
  }
}