Médias

Importer ou téléverser un média

Ajoute à la médiathèque d’un établissement un fichier (multipart) ou une URL https que Sofia récupère. Exige une application live et un abonnement actif.

POSThttps://api.sofia-post.com/api/v1/media

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

{
  "id": "string",
  "type": "image",
  "url": "string"
}

Importer ou téléverser un média

curl --request POST \
  --url 'https://api.sofia-post.com/api/v1/media' \
  --header "Authorization: Bearer $SOFIA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "establishmentId": "string",
  "url": "https://cdn.example.com/tarte-tatin.jpg"
}'

{
  "id": "string",
  "type": "image",
  "url": "string"
}

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.

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.

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

{
  "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.

Autorisations

Authorizationstringheaderrequis
Votre clé personnelle ou jeton d’accès OAuth, envoyé sous la forme Bearer <token>.

En-têtes

Idempotency-Keystring
Rejouée avec le même corps, la requête renvoie la même réponse sans second import. Elle couvre les champs du formulaire, pas les octets du fichier.

Corps

application/json, multipart/form-data

establishmentIdstringrequis
L’établissement dont la médiathèque reçoit le média
urlstring
JSON : l’adresse https du média, que Sofia récupère elle-même (pas de fichier)
filestring<binary>
multipart/form-data : le fichier (image ou vidéo), sans url

Réponse

Le média ajouté à la médiathèque.

idstringrequis
Identifiant du média, à passer dans media[].id d’une publication
typestringrequis
Type du média
Valeurs autorisées : imagevideo
urlstringrequis
Adresse signée, valable pour la fenêtre en cours

Cette page vous a-t-elle aidé ?