Media

Endpoint

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

Importare da un URL

Invia JSON con l'establishmentId e un url https pubblico. Sofia scarica il file da sé, lo controlla e lo salva nella mediateca.

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

Caricare un file

Oppure invia il file stesso come multipart/form-data, con un campo 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-…"
}

Cosa viene accettato

Immagini e video, fino a 200 MB.
Un URL deve essere https pubblico: un indirizzo privato, più di 3 reindirizzamenti o più di 30 secondi di download vengono rifiutati.
L'url restituito è firmato e scade: conserva l'id e rileggi il media con GET /v1/media/{id} quando ti serve un URL nuovo.

Un file rifiutato risponde 422 media_import_refused o media_upload_refused, con il motivo in details e cosa fare in message.