Posts

Suivre le statut d'une publication via l'API

Publier avec Connect est asynchrone : POST /posts répond 202 et le post part ensuite vers le réseau. Pour connaître le résultat, lisez le post par uuid ou listez les posts du client avec des filtres. La réponse contient le status, le lien du post publié et la raison d'un échec.

L'appel

GET /api/posts/<post uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

Ce que vous pouvez faire

  • Lire un post avec GET /posts/{uuid} et voir status, permalink et l'état de la publication.
  • Lister les posts du client avec GET /posts, en filtrant par customer_integration, external_reference et status.
  • Voir l'état de chaque média dans le publishing de chaque élément de media.
  • Obtenir le lien du post sur le réseau dans permalink et l'id du réseau dans publishing.external_id, une fois publié.
  • Retrouver le post par l'id de votre système, en filtrant par external_reference.

Règles et limites

  • POST /posts répond 202 avec le post en created. Interrogez jusqu'à ce que status soit published ou failed.
  • Le status d'un post est created, publishing, published ou failed. publishing.status détaille l'avancement et inclut partially_published.
  • En cas d'échec, publishing.error contient code et message. Décidez d'après code, jamais d'après le message.
  • GET /posts renvoie les posts du client, les plus récents d'abord, avec per_page de 1 à 100 (15 par défaut). Il exige le x-customer-token.
  • Pour voir les posts de tous les clients d'un coup, utilisez GET /merchants/posts, avec le seul Bearer.

Champs principaux

ChampTypeObligatoireDescription
uuidstringNonL'id du post dans Connect, renvoyé par POST /posts.
external_referencestringNonL'id du post dans votre système. Filtre aussi GET /posts.
statusstringNoncreated, publishing, published ou failed. Filtre aussi GET /posts.
permalinkstringNonLe lien du post sur le réseau, une fois publié.
publishing.statusstringNonL'état de la publication : pending, processing, ready, publishing, published, partially_published ou failed. Chaque média a son propre publishing.
publishing.errorobjectNonRenseigné en cas d'échec : code et message. Décidez d'après code, pas le message.
publishing.external_idstringNonL'id que le réseau a donné au post.
customer_integrationstringNonFiltre de GET /posts : l'uuid de la connexion.
per_pageintegerNonÉléments par page dans GET /posts, de 1 à 100. 15 par défaut.

Pour qui

  • Tableau de bord de publications

    Le produit affiche chaque post en file, publié ou en échec, et le permalink dès qu'il existe.

  • Retraiter les échecs

    Un job liste les posts en status failed, lit publishing.error et prévient le client ou réessaie avec une autre external_reference.

  • Agent IA qui confirme la livraison

    L'agent publie, interroge le post jusqu'à status published et ne donne qu'alors le lien du post à l'utilisateur.

Fonctionne avec

  • Instagram Business
  • Facebook
  • Threads
  • LinkedIn
  • Pinterest
  • YouTube

Questions fréquentes

Comment savoir que le post est sorti ?

Lisez GET /posts/{uuid} jusqu'à ce que status soit published ou failed. Avec published, permalink contient le lien du post sur le réseau.

Comment retrouver un post par l'id de mon système ?

Utilisez GET /posts avec external_reference, l'id du post dans votre système. Vous pouvez aussi filtrer par status et customer_integration.

Que signifie failed ?

La publication n'a pas abouti. publishing.error contient le code et le message du motif.

Voir aussi

Voir tout ce que vous pouvez faire avec Posts

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.