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

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.

Autorizzazioni

Authorizationstringobbligatorio

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

Conservato solo in questa scheda e inviato solo ad api.sofia-post.com. Ottieni una chiave API

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.

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.

limitnumber

Dimensione della pagina, da 1 a 100 (20 per default).

Elencare le pubblicazioni

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

{
  "data": [
    {
      "id": "string",
      "status": "published",
      "establishmentId": "string",
      "scheduledAt": "2026-11-02T10:00:00.000Z",
      "createdAt": "2026-11-02T10:00:00.000Z",
      "targets": [
        {
          "platform": "instagram",
          "accountId": "string",
          "state": "published",
          "permalink": "https://www.instagram.com/p/C1"
        }
      ]
    }
  ]
}

Elencare le pubblicazioni

curl --request GET \
  --url 'https://api.sofia-post.com/api/v1/posts' \
  --header "Authorization: Bearer $SOFIA_API_KEY"

{
  "data": [
    {
      "id": "string",
      "status": "published",
      "establishmentId": "string",
      "scheduledAt": "2026-11-02T10:00:00.000Z",
      "createdAt": "2026-11-02T10:00:00.000Z",
      "targets": [
        {
          "platform": "instagram",
          "accountId": "string",
          "state": "published",
          "permalink": "https://www.instagram.com/p/C1"
        }
      ]
    }
  ]
}

GET /v1/posts elenca tutti i post accessibili al token, i più recenti per primi, filtrati per establishmentId, status, from, to e createdBy (me o app). Un post corrisponde a status quando almeno una delle sue reti è in quello stato. Vedi la paginazione.

Gli stati possibili di un post sono descritti nella pagina Leggere un post.

Autorizzazioni

Authorizationstringheaderobbligatorio
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

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

Questa pagina ti è stata utile?