Publications

Lire une publication

Renvoie une publication avec l’état de chaque réseau, son lien et son erreur éventuelle. En live, toute publication du Workspace ; en test, une simulée.

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

Lire une publication

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

Lisez une publication pour suivre l’état de chacun de ses réseaux : chaque cible passe à published avec son lien permanent, ou à failed avec sa raison. Pour être prévenu sans interroger l’API, enregistrez 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_/"
    }
  ]
}

États

État	Signification
`draft`	Enregistrée, ne part pas
`scheduled`	Partira à `scheduledAt`
`publishing`	En cours d’envoi au réseau
`published`	En ligne, avec son `permalink`
`failed`	Le réseau l’a refusée ; `error` dit pourquoi
`sent_to_inbox`	Envoyée dans l’app du réseau, où le propriétaire la termine (TikTok)

Le status de la publication résume ses cibles. Il vaut partial quand un réseau a publié et qu’un autre a échoué.

Autorisations

Authorizationstringheaderrequis
Votre clé personnelle ou jeton d’accès OAuth, envoyé sous la forme Bearer <token>.

Paramètres de chemin

idstringrequis
Identifiant de la publication.

Réponse

La publication et l’état de chaque cible.

idstringrequis
Identifiant de la publication
statusstringrequis
Sur l’ensemble des réseaux ; partial : publiée sur l’un, échouée sur l’autre
Valeurs autorisées : draftscheduledpublishingpublishedsent_to_inboxfailedpartial
establishmentIdstringrequis
Établissement de la publication
createdAtstring<date-time>requis
Moment où la publication a été créée
targetsobject[]requis
Une entrée par réseau et par compte : deux comptes sur un même réseau, deux entrées
Afficher les attributs enfants
- platformstringrequis
  Réseau de la cible
- accountIdstringrequis
  Le compte qui publie (GET /v1/establishments/:id/accounts)
- statestringrequis
  État de la cible sur son réseau
  Valeurs autorisées : draftscheduledpublishingpublishedsent_to_inboxfailed
- publishedAtstring<date-time>
  Moment où la cible a été publiée
- permalinkstring
  Lien vers la publication sur le réseau
- errorstring
  Pourquoi le réseau a refusé
scheduledAtstring<date-time>
Moment où la publication doit paraître

Cette page vous a-t-elle aidé ?