Pubblicazioni

Elencare le pubblicazioni

Elenca le pubblicazioni delle attività raggiungibili dal token, le più recenti prima, filtrabili per attività, stato, date e autore, pagina per pagina.

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

GET/v1/posts

Chiave API o access tokenConservato solo in questa scheda e inviato solo ad api.sofia-post.com.establishmentId (query)cursor (query)status (query)from (query)to (query)createdBy (query)limit (query)

curl -X GET 'https://api.sofia-post.com/api/v1/posts' \
  -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

establishmentIdstring
Solo le pubblicazioni di questa attività.
cursorstring
Il nextCursor della pagina precedente.
statusstring
Live: almeno una rete in questo stato. Lo status della pubblicazione riassume le sue reti, quindi filtrare su failed può restituire partial.
Valori ammessi: draftscheduledpublishingpublishedsent_to_inboxfailed
fromstring<date-time>
Live: almeno una rete pubblicata (o, prima della pubblicazione, programmata) da questo istante.
tostring<date-time>
Live: e prima di questo istante (escluso).
createdBystring
Live: me per le pubblicazioni della persona per cui agisce il token, app per quelle create da questa applicazione. Assente: tutte.
Valori ammessi: meapp
limitnumber
Dimensione della pagina, da 1 a 100 (20 per default).

Risposta

200application/json

Una pagina di pubblicazioni, con nextCursor quando ce ne sono altre.

dataobject[]obbligatorio
Le pubblicazioni della pagina
Mostra gli attributi figli
- idstringobbligatorio
  Identificatore della pubblicazione
- statusstringobbligatorio
  Su tutte le reti; partial: pubblicata su una, fallita su un'altra
  Valori ammessi: draftscheduledpublishingpublishedsent_to_inboxfailedpartial
- establishmentIdstringobbligatorio
  Attività della pubblicazione
- createdAtstring<date-time>obbligatorio
  Quando la pubblicazione è stata creata
- targetsobject[]obbligatorio
  Una voce per rete e account: due account sulla stessa rete, due voci
  Mostra gli attributi figli
  - platformstringobbligatorio
    Rete della destinazione
  - accountIdstringobbligatorio
    L'account che pubblica (GET /v1/establishments/:id/accounts)
  - statestringobbligatorio
    Stato della destinazione sulla sua rete
    Valori ammessi: draftscheduledpublishingpublishedsent_to_inboxfailed
  - publishedAtstring<date-time>
    Quando la destinazione è stata pubblicata
  - permalinkstring
    Link alla pubblicazione sulla rete
  - errorstring
    Perché la rete ha rifiutato
- scheduledAtstring<date-time>
  Quando la pubblicazione è programmata
nextCursorstring
Passalo come ?cursor= per la pagina successiva; assente alla fine

400

invalid_cursor, o invalid_request per un parametro malformato.

401

Il token manca, è sconosciuto, scaduto o revocato.

403

Il token non ha il permesso posts:read.

404

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

4XXapplication/json

Qualsiasi altro errore, nella busta di errore.