メディア

エンドポイント

POST/v1/mediaGET/v1/mediaGET/v1/media/{id}DELETE/v1/media/{id}

URL からインポートする

establishmentId と公開 https の url を含む JSON を送信します。Sofia がファイルを自らダウンロードし、検証して、メディアライブラリに保存します。

bash

curl -X POST https://api.sofia-post.com/api/v1/media \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"establishmentId":"'$ESTABLISHMENT_ID'","url":"https://images.example.com/tatin.jpg"}'

ファイルをアップロードする

または、ファイルそのものを multipart/form-data で、file フィールドに入れて送信します。

bash

curl -X POST https://api.sofia-post.com/api/v1/media \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -F establishmentId=$ESTABLISHMENT_ID \
  -F file=@tatin.jpg

json

{
  "id": "393d5aa4-16f1-430f-b1d8-1fb1473076ef",
  "type": "image",
  "url": "https://…/393d5aa4-16f1-430f-b1d8-1fb1473076ef.jpg?X-Amz-…"
}

受け付けるもの

画像と動画、最大 200 MB。
URL は公開された https である必要があります。プライベートアドレス、4 回以上のリダイレクト、30 秒を超えるダウンロードは拒否されます。
返される url は署名付きで、有効期限があります。id を保存しておき、新しい URL が必要なときは GET /v1/media/{id} でメディアを再取得してください。

拒否されたファイルは 422 media_import_refused または media_upload_refused で応答され、理由は details に、対処方法は message に記載されます。