Media

Importare o caricare un media

Aggiunge alla mediateca di un'attività un file (multipart) o un URL https che Sofia scarica. Richiede un'app live e un abbonamento attivo.

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

Importare o caricare un media

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

Importare da un URL

Invia JSON con l’establishmentId e un url https pubblico. Sofia scarica da sola il file, lo controlla e lo mette nella libreria 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":"'$ESTABLISHMENT_ID'","url":"https://images.example.com/tatin.jpg"}'

Caricare un file

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

Cosa è 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 aggiornato.

Un file rifiutato risponde 422 media_import_refused o media_upload_refused, con il motivo in details e la procedura da seguire in message.

Autorizzazioni

Authorizationstringheaderobbligatorio
La tua chiave personale o il token di accesso OAuth, inviato come Bearer <token>.

Header

Idempotency-Keystring
Ripetuta con lo stesso body, la richiesta restituisce la stessa risposta senza una seconda importazione. Copre i campi del modulo, non i byte del file.

Body

application/json, multipart/form-data

establishmentIdstringobbligatorio
L'attività la cui mediateca riceve il media
urlstring
JSON: l'indirizzo https del media, che Sofia scarica da sola (nessun file)
filestring<binary>
multipart/form-data: il file (immagine o video), senza url

Risposta

Il media aggiunto alla mediateca.

idstringobbligatorio
Identificatore del media, da passare in media[].id di una pubblicazione
typestringobbligatorio
Tipo del media
Valori ammessi: imagevideo
urlstringobbligatorio
Indirizzo firmato, valido per la finestra corrente

Questa pagina ti è stata utile?