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
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| customer | string | Non | Filtre : l'uuid d'un customer du merchant. |
| customer_integration | string | Non | Filtre : l'uuid d'une connexion d'un customer du merchant. |
| status | string | Non | Filtre : created, publishing, published ou failed. |
| external_reference | string | Non | Filtre : l'id du post dans votre système (100 caractères max). |
| per_page | integer | Non | Éléments par page, de 1 à 100. 15 par défaut. |
| customer_uuid | string | Non | Sur 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}.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
