メインコンテンツへスキップ
POST
このエンドポイントを使うと、投稿に含めるファイル(画像または小さな動画)をアップロードできます。返されるURLは/postエンドポイントで使用できます。 ファイルは、フォームパラメータとして_multipart form data_で渡すか、ボディパラメータとしてBase64エンコードされたファイルで渡すことができます。 メディアアップロードに関する重要な注意事項:
  1. 最高のパフォーマンスのために、以下をお勧めします
    • 自身のサーバー(例: AWS S3)にメディアファイルをホスティングする。
    • /postエンドポイントのmediaUrlsパラメータにメディアURLを直接渡す。
    • このエンドポイントを介してファイルをアップロードするより高速です。
  2. メディアファイルの保持
    • アップロードされたファイルは90日間保存されます。
    • 90日経過後:
      • ソーシャルネットワーク上で公開された投稿は影響を受けません。
      • スケジュール済み投稿が期限切れのメディアを参照している場合、公開に失敗します。
  3. ファイルサイズ制限
S3バケットなど外部URLでメディアにアクセス可能な場合、Ayrshareへのファイルアップロードをスキップできます。外部からアクセス可能なURLをmediaURLsボディパラメータに指定して/postエンドポイントへPOSTするだけで、ファイルは自動的にアップロードされます。

ヘッダーパラメータ

Content-Type
string
必須
multipart form dataを送信する場合はmultipart/form-dataを使用します - 以下を参照してください。それ以外の場合は、標準のapplication/jsonを送信してください。

ボディパラメータ

file
string or object
必須
最大30 MBのファイルサイズ。Base64エンコードではなく、multipart form-dataオブジェクトとして送信することをお勧めします。
fileName
string
アップロードするファイルの名前。
description
string
ファイルの説明。

Multipart Form-Dataとして送信

メディアファイルをmultipart form-dataオブジェクトとして送信します。上記のようにContent-Typeを必ず指定してください。

Base64として送信

メディアファイルをData URI文字列としてBase64エンコードされた文字列で送信します。文字列はdata:content/type;base64で始まる必要があります。 Data URI出力形式でのエンコード例: 注意: /postエンドポイントは、mediaUrlsパラメータを使用して外部URL経由でより大きなファイルを受け入れます。