一度アップロードして、どこにでも公開
メディアライブラリにファイルを送るとIDが返ります。そのIDをいくつの投稿にでも添付でき、FoPostが各ネットワークに合った形に変換して配信します。ストレージはプライベートで、ワークスペース単位です。
curl -X POST "https://api.fopost.com/v1/media/upload?workspace_id=9b2f6c1e-..." \
-H "X-API-Key: $API_KEY" \
-F "[email protected]"
{
"data": [
{
"id": "e5a1c9d4-...",
"type": "image",
"name": "launch.png",
"url": "https://.../launch.png",
"preview_url": "https://api.fopost.com/v1/media/e5a1c9d4-.../file",
"size": 412883
}
]
}マルチパートアップロード
50 MBまでの画像と動画に対応。拡張子だけでなく中身で検証します。
IDで再利用
1回のアップロードで、いくつの投稿にも。ファイルを二度送ることはありません。
標準でプライベート
ファイルはプライベートストレージに保存され、ワークスペースのメンバーにだけ配信されます。
入口はひとつ。到着時にチェック
すべてのファイルは同じ経路を通ります。MIMEの許可リスト、実際のバイトの検査、サイズ上限、アカウントの無料ストレージ枠。返ってくるのは種類とサイズを含むライブラリの行で、すぐに添付できます。
メディアリファレンスを読むcurl -X POST https://api.fopost.com/v1/posts \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspace_id": "9b2f6c1e-...",
"content": [{ "text": "Launch day.", "media": [{ "type": "image", "name": "launch.png", "url": "https://.../launch.png" }] }],
"accounts": ["4a71d80b-..."]
}'画像
PNG、JPEG、GIF、WebPに対応し、アップロード時に種類とサイズを読み取ります。
動画
MP4とMOVに対応し、公開時に各ネットワークの基準で長さとサイズをチェックします。
検証済み
ファイルの実際の中身が種類と一致しなければ、アップロードは拒否されます。
ネットワークごとに最適な形式へ、自動で
アスペクト比、サイズ、コーデックの条件はネットワークごとに異なります。公開時には各アダプターが保存済みの元ファイルから、そのプラットフォームが受け付ける形式でアップロードします。ライブラリの1つの素材が、カルーセルでも、スレッドでも、ショート動画のフィードでも使えます。
配信の仕組みを見る
ネットワークごとのルール
サイズと形式の制限は、利用者ではなくアダプターが適用します。
メディアの順序
コンテンツブロック内の順序が、そのままカルーセルの順序になります。
わかりやすい失敗
ネットワークが受け付けないファイルは、投稿全体ではなくその配信だけを、理由とともに失敗にします。
ライブラリの閲覧、取得、再利用
フィルター付きでライブラリを一覧し、リクエストごとにワークスペースのメンバーシップを確認する期限切れのないファイルエンドポイントで任意の素材を取得し、同じIDを好きなだけ多くの投稿から参照できます。ブランド素材、インポートしたファイル、生成した画像は、すべて同じライブラリに入ります。
開発を始めるcurl "https://api.fopost.com/v1/media?workspace_id=9b2f6c1e-...&type=image" \
-H "X-API-Key: $API_KEY"
# Fetch the file itself
curl -L "https://api.fopost.com/v1/media/e5a1c9d4-.../file" \
-H "X-API-Key: $API_KEY" -o launch.png一覧と絞り込み
種類、取得元、ブランドでの役割で絞り込み、ページ単位で取得できます。
変わらないファイルURL
/v1/media/:id/file always works for members; no signed links to refresh.
ワークスペース単位
キーが見られるのは、1つのワークスペースのライブラリだけです。