Media

Elencare i media

Elenca la mediateca di un'attività, i più recenti prima, pagina per pagina, con URL firmati per la finestra corrente. Funziona in test e in live.

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

Elencare i media

curl -X GET 'https://api.sofia-post.com/api/v1/media' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

{
  "data": [
    {
      "id": "string",
      "type": "image",
      "url": "string",
      "fileName": "tarte-tatin.jpg",
      "contentType": "image/jpeg",
      "size": 482113,
      "createdAt": "2026-11-02T10:00:00.000Z"
    }
  ]
}

Elencare i media

curl --request GET \
  --url 'https://api.sofia-post.com/api/v1/media?establishmentId=<establishmentId>' \
  --header "Authorization: Bearer $SOFIA_API_KEY"

{
  "data": [
    {
      "id": "string",
      "type": "image",
      "url": "string",
      "fileName": "tarte-tatin.jpg",
      "contentType": "image/jpeg",
      "size": 482113,
      "createdAt": "2026-11-02T10:00:00.000Z"
    }
  ]
}

I media di un’attività vengono restituiti dal più recente, pagina per pagina: vedi la paginazione.

L’url di ogni media è firmato e scade: conserva l’id, e rileggi il media con `GET /v1/media/{id}` quando ti serve un URL aggiornato.

Autorizzazioni

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

Parametri di query

establishmentIdstringobbligatorio
L'attività di cui si legge la mediateca.
cursorstring
Il nextCursor della pagina precedente.
limitnumber
Dimensione della pagina, da 1 a 100 (20 per default).

Risposta

Una pagina di media, con nextCursor quando ce ne sono altri.

dataobject[]obbligatorio
I media della pagina
Mostra gli attributi figli
- 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
- fileNamestringobbligatorio
  Nome del file
- contentTypestringobbligatorio
  Tipo MIME del file
- sizenumberobbligatorio
  Dimensione in byte
- createdAtstring<date-time>obbligatorio
  Quando il media è stato aggiunto
- thumbnailUrlstring
  Miniatura firmata (copertina di un video, quadrato di un'immagine)
nextCursorstring
Passalo come ?cursor= per la pagina successiva; assente alla fine

Questa pagina ti è stata utile?