Pubblicazioni

Leggere una pubblicazione

Restituisce una pubblicazione con lo stato di ogni rete, il link una volta pubblicata e l'errore. Live: ogni pubblicazione del Workspace; test: una simulata.

GEThttps://api.sofia-post.com/api/v1/posts/{id}

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

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

Leggere una pubblicazione

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

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

Leggi un post per seguire lo stato di ciascuna delle sue reti: ogni destinazione passa a published con il suo permalink, o a failed con il suo motivo. Per essere avvisato senza interrogare l’API, registra un webhook.

{
  "id": "efc578cc-ef79-40e9-876d-be1a33d3b8db",
  "status": "published",
  "targets": [
    {
      "platform": "instagram",
      "state": "published",
      "publishedAt": "2026-11-02T20:17:25.453Z",
      "permalink": "https://www.instagram.com/p/DfQJVPGFfb_/"
    }
  ]
}

Stati

Stato	Significato
`draft`	Salvato, non esce
`scheduled`	Uscirà a `scheduledAt`
`publishing`	In corso di invio alla rete
`published`	Online, con il suo `permalink`
`failed`	La rete l’ha rifiutato; `error` dice perché
`sent_to_inbox`	Inviato nell’app della rete, dove il titolare lo termina (TikTok)

Lo status del post riassume le sue destinazioni. Vale partial quando una rete ha pubblicato e un’altra è fallita.

Autorizzazioni

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

Parametri di percorso

idstringobbligatorio
Identificatore della pubblicazione.

Risposta

La pubblicazione e lo stato di ogni destinazione.

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

Questa pagina ti è stata utile?