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
  }
}

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.