Comment créer un planificateur de publications via une API : la file d'attente, les médias et les statuts
Pour créer un planificateur de publications avec l'API partenaire d'easyCoexistence, votre backend envoie chaque publication à POST /channels/:id/posts avec son texte, ses médias et un publish_at situé de 1 minute à 90 jours à l'avance. easyCoexistence copie aussitôt les médias et publie à l'heure prévue sur Instagram, Facebook, TikTok ou LinkedIn, en signalant chaque étape par un statut et par les événements post.published et post.failed.
Délai maximal de programmation de l'API des publications sur Instagram, Facebook, TikTok et LinkedIn ; le délai minimal est de 1 minute.
Taille maximale d'image et de vidéo copiées par easyCoexistence à la programmation ; un fichier plus lourd est refusé à ce moment-là.
Nouvelles tentatives d'une publication limitée en débit par un réseau, avant qu'elle soit marquée comme en échec.
Publications envoyées par API qu'un compte Instagram peut effectuer sur 24 heures glissantes ; un carrousel compte pour une seule.
Plafond de TikTok sur les publications vidéo par compte via son endpoint de publication, avec six au maximum par minute.
De quoi un planificateur a-t-il besoin de l'API ?
Cinq éléments : un moyen d'importer des fichiers, un appel qui met une publication en file pour un compte, une file qui publie à l'heure, un moyen de la modifier et un retour sur ce qui s'est passé. L'API des publications fournit chacun d'eux avec la même clé ec_live_ qui connecte vos clients, de sorte que le calendrier, le flux d'approbation et le compositeur restent dans votre produit.
Comment programmer une publication ?
Avec un POST par compte vers https://easycoexistence.com/api/v1/channels/:id/posts, où :id est le channel_id issu de la session de connexion du client. publish_at est au format ISO 8601 avec un Z ou un décalage ; omettez-le pour publier immédiatement. La réponse est 201 avec la publication, ou 422 lorsqu'une publication prévue pour maintenant a échoué. L'en-tête Idempotency-Key est pris en compte : une requête répétée après un délai d'attente ne met pas la publication en file deux fois. Le corps accepte :
- text : la légende, le message ou le commentaire ; media : une liste de {url, type} ou {
media_id}. - link : une publication de lien Facebook ou un article LinkedIn, avec un titre sur LinkedIn.
ig_type: IMAGE, CAROUSEL, REELS ou STORIES, déduit des médias lorsqu'il est omis.- title et
disable_commentpour les publications photo TikTok ;image_altpour une image LinkedIn.
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Idempotency-Key: campaign-311-ig" \
-H "Content-Type: application/json" \
-d '{
"text": "Three looks for the weekend",
"media": [
{ "url": "https://cdn.example.com/looks/1.jpg", "type": "image" },
{ "url": "https://cdn.example.com/looks/2.jpg", "type": "image" }
],
"ig_type": "CAROUSEL",
"publish_at": "2026-11-20T09:00:00-05:00"
}'Comment le planificateur gère-t-il les médias ?
Soit par lien, soit par envoi de fichier. Un lien HTTPS public est placé directement dans media ; un fichier envoyé par vos utilisateurs part vers POST /media, comme corps de la requête avec son Content-Type et son Content-Length, ou comme {"url"}, et le media_id renvoyé est ajouté à la publication. Lors de la programmation, easyCoexistence copie les fichiers : votre lien n'a donc besoin de fonctionner qu'à cet instant. Une page web à la place d'un fichier, une erreur 404, un mauvais type ou un fichier de plus de 30 Mo pour les images ou de 1 Go pour les vidéos est refusé à ce moment-là, et non le matin de la publication.
Que peut porter la publication de chaque réseau ?
La file vérifie chaque publication selon les règles du réseau avant de l'accepter ; une publication qui en enfreint une est refusée avec un message qui nomme la règle, afin que votre compositeur puisse afficher le problème pendant que l'utilisateur modifie encore son contenu. Chaque réseau accepte :
Par quels statuts passe une publication ?
Six, que GET /posts/:id et GET /posts renvoient, avec publish_at, le lien de la publication une fois en ligne et l'erreur du réseau en cas d'échec :
- scheduled : en file d'attente jusqu'à son heure.
- publishing : transmise au réseau.
- processing : le réseau travaille encore dessus, comme pour une vidéo TikTok ou un conteneur Instagram.
- published : en ligne, avec son lien.
- failed : refusée ou non confirmée ;
may_be_publishedsignale une publication que le réseau a pu recevoir. - canceled : retirée avant sa publication, par vous ou parce que son canal a été supprimé ou suspendu.
Comment modifier, annuler ou relancer une publication ?
PATCH /posts/:id modifie l'heure ou le texte d'une publication programmée, et le titre d'une publication photo TikTok ; pour changer ses médias, annulez-la et programmez-en une nouvelle. DELETE /posts/:id l'annule. POST /posts/:id/retry publie à nouveau une publication en échec, immédiatement. Une publication limitée en débit par un réseau est relancée automatiquement après 5 minutes, 30 minutes puis 2 heures, et une publication marquée may_be_published doit être vérifiée sur le compte avant toute nouvelle tentative.
Comment votre planificateur est-il informé de ce qui s'est passé ?
Par les événements et par la liste. L'URL des événements de statut configurée sous Profil, Développeurs reçoit post.published et post.failed, signés avec X-EC-Signature comme tous les autres événements, avec la publication et son canal, pour que votre calendrier la marque en ligne ou la signale. GET /posts accepte status, from, to et limit pour les vues calendrier, et GET /channels/:id/posts liste un seul compte. Une publication qui échoue en arrière-plan envoie aussi un e-mail au propriétaire du compte, au plus une fois par canal toutes les 3 heures.
Comment les publications LinkedIn s'intègrent-elles à un planificateur ?
Avec une personne qui approuve chacune d'elles. Les conditions d'API de LinkedIn limitent l'usage de ses API pour automatiser les publications ; un planificateur conserve donc chaque publication LinkedIn comme brouillon dans votre produit jusqu'à ce qu'une personne nommée l'approuve, puis l'envoie avec son publish_at. Les règles récurrentes, les flux et les imports en masse doivent viser les autres réseaux, et LinkedIn ne doit recevoir que des publications relues par quelqu'un.
Erreurs courantes
- Envoyer publish_at sans décalage. Une heure locale sans Z ni décalage est refusée ; envoyez donc 2026-11-20T09:00:00-05:00 plutôt que l'heure nue choisie par votre utilisateur.
- Relancer aussitôt une publication marquée may_be_published. Le réseau peut déjà l'afficher ; vérifiez donc d'abord le compte, sinon la publication part deux fois.
- Répéter un POST arrivé à expiration sans Idempotency-Key. Donnez à chaque publication sa propre clé : une requête répétée renvoie alors la publication déjà mise en file au lieu d'en programmer une seconde copie.
- Fournir des PNG pour Instagram. L'API de publication d'Instagram n'accepte que le JPEG, et la publication est refusée à la programmation ; convertissez donc les images dans votre étape d'envoi.
easyCoexistence offre à votre planificateur une seule file pour les comptes Instagram, Facebook, TikTok et LinkedIn de vos clients, et d'autres canaux, via l'API officielle de chaque réseau : médias copiés à la programmation, six statuts, nouvelles tentatives en cas de limitation de débit et événements de publication signés, avec chaque connexion surveillée 24h/24 et 7j/7. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Une seule requête peut-elle programmer une publication sur plusieurs réseaux ?
Chaque requête vise un seul canal : envoyez-en une par compte, chacune avec sa propre Idempotency-Key, et adaptez le texte aux limites de chaque réseau.
L'API des publications programme-t-elle des vidéos YouTube ?
YouTube programme nativement. Envoyez la vidéo via l'API YouTube en privé avec publishAt, en utilisant le token issu de GET /channels/:id?credentials=1 ; YouTube la rend publique à cette heure-là.
Mes utilisateurs peuvent-ils voir leurs publications programmées dans le tableau de bord d'easyCoexistence ?
L'écran Publications appartient à votre compte : votre équipe y voit À traiter, À venir et Publiées, avec Annuler, Réessayer et Ignorer. Vos utilisateurs voient le calendrier que votre produit construit à partir de GET /posts.
Combien coûte easyCoexistence pour un planificateur de publications sur réseaux sociaux ?
De US$ 9 à US$ 0,75 par compte connecté et par mois, dégressif à mesure que vos utilisateurs connectent davantage de comptes, avec la programmation incluse et un essai gratuit de 3 jours.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le