PublicationsLire une publication
Retour à Sofia

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

Autorisations

  • Authorizationstringrequis

    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

200application/json

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

401

Le jeton est absent, inconnu, expiré ou révoqué.

403

Le jeton n’a pas la permission posts:read.

404

post_not_found : hors du Workspace (ou de l’autorisation en test).

4XXapplication/json

Toute autre erreur, dans l’enveloppe d’erreur.