MediaElencare i media
Torna a Sofia

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
GET/v1/media
curl -X GET 'https://api.sofia-post.com/api/v1/media' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

Autorizzazioni

  • Authorizationstringobbligatorio

    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

200application/json

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

400

invalid_cursor, o invalid_request.

404

establishment_not_found: l'attività non è raggiungibile dal token.

4XXapplication/json

Qualsiasi altro errore, nella busta di errore.