Posts

Lister les posts de tous les clients via l'API

GET /merchants/posts renvoie d'un coup les posts de tous vos clients, les plus récents d'abord, avec le seul token du merchant. C'est la vue de suivi : où des posts ont échoué, ce qui a été publié et pour quel client.

L'appel

GET /api/merchants/posts?status=failed&per_page=50
Authorization: Bearer <merchant token>

Ce que vous pouvez faire

  • Lister les posts de tous les customers en un appel, sans x-customer-token.
  • Filtrer par un customer avec customer, ou par une connexion avec customer_integration.
  • Filtrer par status (created, publishing, published, failed) pour repérer les échecs.
  • Retrouver un post par l'id de votre système avec external_reference.
  • Paginer avec per_page, de 1 à 100.

Règles et limites

  • Seulement le Bearer du merchant, sans x-customer-token. Pour les posts d'un seul client, utilisez GET /posts avec le x-customer-token.
  • customer et customer_integration sont des filtres, pas des identifiants : le client et la connexion sont vérifiés par rapport au merchant du Bearer.
  • Les filtres se combinent. La liste arrive avec les plus récents d'abord, 15 par page par défaut.
  • Chaque post porte customer_uuid, pour savoir à quel client il appartient.

Champs principaux

ChampTypeObligatoireDescription
customerstringNonFiltre : l'uuid d'un customer du merchant.
customer_integrationstringNonFiltre : l'uuid d'une connexion d'un customer du merchant.
statusstringNonFiltre : created, publishing, published ou failed.
external_referencestringNonFiltre : l'id du post dans votre système (100 caractères max).
per_pageintegerNonÉléments par page, de 1 à 100. 15 par défaut.
customer_uuidstringNonSur chaque post de la réponse : le customer propriétaire du post.

Pour qui

  • Tableau de bord des opérations

    L'équipe support voit tous les posts en échec de tous les clients sur un seul écran, sans interroger client par client.

  • Alertes d'échec

    Un job périodique liste les status failed et prévient le responsable de chaque compte.

  • Agent IA de suivi

    L'agent résume la semaine de publications par client et met en avant ceux qui ont le plus échoué.

Fonctionne avec

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

Questions fréquentes

Ai-je besoin du x-customer-token ?

Non. Cette route utilise uniquement le Bearer du merchant. GET /posts, par client, exige le x-customer-token.

Comment voir un seul client ?

Passez customer avec l'uuid du customer, ou customer_integration avec l'uuid de la connexion.

Comment trouver les posts en échec ?

Filtrez par status=failed. Pour le détail de l'erreur, lisez le post avec GET /posts/{uuid}.

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.