メインコンテンツへスキップ
GET
10 MBを超えるファイルアップロードの場合、プリサインドURLを取得してファイルをアップロードします。
  • 最大ファイルアップロードサイズは5 GBです。
  • アップロードプリサインドURLは、生成後30分間有効です。
  • アクセスURLは、アップロード後30日間利用可能です。すでに公開された投稿はソーシャルネットワーク上で影響を受けません。その期間を超えてスケジュールされた投稿は、公開時にエラーが発生します。
S3バケットなど、外部URLでアクセス可能なメディアが既にある場合、ファイルをAyrshareにアップロードする必要はありません。外部からアクセス可能なURLをmediaURLsボディパラメータに指定して/postエンドポイントにPOSTするだけで、ファイルは自動的にアップロードされます。

ヘッダーパラメータ

クエリパラメータ

fileName
string
contentTypeが存在しない場合は、拡張子付きの完全なファイル名が必要です。アップロードするファイルの名前。.png、.jpg、.mov、.mp4などの拡張子を含める必要があります。
contentType
string
アップロードするメディアのcontent-type。有効な形式には次が含まれます: mp4movpngjpgjpegたとえば、ファイルがQuicktime .movファイルの場合、contentTypeはmovにする必要があります。存在しない場合、application/octet-streamが使用されます。

レスポンスの詳細

  • accessUrlは、アップロード後にメディアファイルにアクセスするためのURLです。
  • contentTypeは、アップロードするメディアに設定されたcontent-typeです。メディアをアップロードする際に、これを_Content-Type_ヘッダーで使用します。
  • uploadUrlは、メディアファイルを_PUT_するために使用するURLです。以下をご覧ください。

追加のエンドポイントの例

大きなファイルをアップロードするプロセス:
  • /media/uploadUrlエンドポイント経由でuploadURLaccessURLを取得します。上記を参照してください。
  • 返されたcontentTypeに設定された_Content-Type_で_PUT_を介してファイルをアップロードします。
  • メディアファイルとuploadUrlを使用して--upload-fileでメディアをアップロードします。
  • アップロードが成功すると、200レスポンスが返されます。
  • メディアファイルをアップロードした後、accessUrlmediaUrlsボディパラメータで/postエンドポイントにPOSTします。
  • プリサインドアップロードURLは1回のみアップロードできます。不正なファイルを送信した場合、新しいアップロードURLを作成する必要があります。ファイルが正常にアップロードされなくても、エラーレスポンスは発生しません。以下のURLが存在することを確認するを参照してください。
uploadUrlを作成する際に設定したcontentTypeが、ファイルをPUTする際のContent-Typeおよびファイルタイプと一致することを確認してください。 たとえば、uploadUrlを作成する際にcontentTypeを”image/png”に設定した場合、Content-Type: image/pngを設定し、アップロードするファイルが.pngで終わることを確認してください。 アップロードが成功すると、200レスポンスが返されます。

Node.jsでのバイナリファイルアップロード例

Node.jsとJavaScriptを使用してバイナリメディアファイルをアップロードする例を以下に示します:

Postmanでのバイナリファイルアップロード例

Postmanを使用して、バイナリファイルをuploadUrlにアップロードすることもできます。 Postmanで:
  1. HTTPメソッドPUTを選択します。
  2. uploadUrlをURLフィールドに貼り付けます。注意: URLは1時間後に期限切れになり、1回のみ使用できます。呼び出しに失敗した場合は、uploadUrlを再生成する必要があります。
  3. _Headers_で、Content-Typeを/uploadUrlエンドポイントで返されるcontent typeに設定します。例: Content-Type: image/png
  4. _Body -> binary_を選択して、アップロードするファイルを選択します。
  5. Sendを押します。
  6. 重要: 戻りレスポンスは発生しないため、/uploadUrlエンドポイントから返されたaccessUrlをブラウザで開いてアップロードが成功したかを確認する必要があります。verify URLエンドポイントを使用することもできます。
Postman Binary Upload

Postmanサンプル JSONファイル