Médias

Endpoints

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

Importer depuis une URL

Envoyez du JSON avec l’establishmentId et une url https publique. Sofia télécharge elle-même le fichier, le contrôle et le range dans la médiathèque.

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

Téléverser un fichier

Ou envoyez le fichier lui-même en multipart/form-data, avec un champ 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-…"
}

Ce qui est accepté

Images et vidéos, jusqu’à 200 Mo.
Une URL doit être en https public : une adresse privée, plus de 3 redirections ou plus de 30 secondes de téléchargement sont refusées.
L’url renvoyée est signée et expire : conservez l’id, et relisez le média avec GET /v1/media/{id} quand il vous faut une URL fraîche.

Un fichier refusé répond 422 media_import_refused ou media_upload_refused, avec la raison dans details et la marche à suivre dans message.