API de publicationAPI

Un seul POST pour publier partout

Créez une publication une seule fois, listez les comptes à atteindre, et FoPost s'occupe de la mise en forme, de l'envoi des médias et de la diffusion sur chaque réseau. Clés à portée limitée, requêtes idempotentes et état de diffusion à interroger ou à recevoir par webhook.

Obtenir votre clé APILire la documentation
POST /v1/posts
curl -X POST https://api.fopost.com/v1/posts \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "9b2f6c1e-...",
    "content": [{ "text": "Shipped a new release today." }],
    "accounts": ["4a71d80b-...", "c30e9f12-..."]
  }'

curl -X POST https://api.fopost.com/v1/posts/7d3e0a52-.../publish \
  -H "X-API-Key: $API_KEY"

Tous les réseaux, un seul format

Le même corps de requête publie sur X, LinkedIn, Instagram et tout autre compte connecté.

Clés à portée limitée

Une clé avec l'autorisation publish peut publier, et rien d'autre. Révoquez-la sans toucher aux autres.

Diffusion par compte

Chaque compte indique son propre statut, son identifiant externe et son permalien une fois la publication en ligne.

Publier

Rédigez la publication une fois, ciblez n'importe quels comptes

Transmettez le texte, les médias et les comptes à atteindre. FoPost applique les limites et les codes de chaque réseau, envoie les médias au format attendu par la plateforme et renvoie un identifiant de publication à suivre. Fils, carrousels et textes longs passent tous par le même tableau de contenu.

Lire la référence de publication
Réponse
{
  "post_status": "publishing",
  "deliveries": [
    { "id": "a3c5e7f9-...", "account_id": "4a71d80b-...", "status": "queued", "external_url": null, "posted_at": null, "attempts": 0 },
    { "id": "b4d6f8a0-...", "account_id": "c30e9f12-...", "status": "queued", "external_url": null, "posted_at": null, "attempts": 0 }
  ],
  "health_warnings": []
}

Blocs de contenu

Des blocs ordonnés deviennent un fil, un carrousel ou un corps de texte selon le réseau.

Médias par référence

Envoyez une fois dans la médiathèque et attachez par identifiant à autant de publications que nécessaire.

Idempotent

Envoyez une clé d'idempotence : une requête relancée ne publie jamais en double.

Suivre

Sachez exactement où chaque publication est arrivée

Une publication se décline en une diffusion par compte. Interrogez l'endpoint des diffusions ou abonnez-vous à un webhook pour obtenir le statut de la plateforme, l'identifiant externe, le permalien et le texte de l'erreur lorsqu'un réseau refuse quelque chose.

Voir les événements webhook
Comptes connectés sur tous les réseaux dans un seul espace de travail

Endpoint des diffusions

GET /v1/posts/:id/deliveries liste chaque compte avec son propre statut.

Événements webhook

delivery.published et delivery.failed se déclenchent dès qu'une diffusion est terminée.

Nouvelles tentatives intégrées

Les erreurs temporaires des plateformes sont retentées avec backoff avant d'apparaître comme échecs.

Gérer

Modifiez, annulez et supprimez depuis votre code

Tout le cycle de vie est disponible via l'API. Modifiez une publication programmée avant son envoi, annulez-la ou supprimez une publication en ligne du réseau où elle a été diffusée. Les libellés et les espaces de travail séparent le travail de vos clients lorsque vous gérez plusieurs marques.

Commencer à développer
PUT /v1/posts/:id
curl -X PUT https://api.fopost.com/v1/posts/7d3e0a52-... \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "content": [{ "text": "Updated copy." }] }'

Modifier avant publication

Changez le texte, les médias ou les comptes de tout ce qui est encore en file.

Libellés

Étiquetez les publications par campagne ou par client, et filtrez chaque endpoint de liste par libellé.

Espaces de travail

Les clés sont propres à chaque espace de travail : un client ne peut jamais accéder à un autre.

API de publication : vos questions, nos réponses

Comment m'authentifier ?

Créez une clé API dans le tableau de bord, sous Settings, puis envoyez-la dans un en-tête X-API-Key. Chaque clé appartient à un seul espace de travail et ne porte que les autorisations que vous lui accordez.

Sur quels réseaux puis-je publier ?

Tous les comptes connectés à l'espace de travail, sur tous les réseaux pris en charge par FoPost. Le format de la requête est le même pour tous.

Puis-je joindre des images et des vidéos ?

Oui. Envoyez le média une seule fois via la Media API, puis référencez son identifiant dans la publication. Les limites de taille et de format de chaque réseau sont appliquées pour vous.

Que se passe-t-il si un réseau est en panne ?

La diffusion est retentée avec backoff. Si elle échoue encore, elle est marquée en échec avec l'erreur de la plateforme, et un webhook delivery.failed se déclenche.

Y a-t-il une limite de débit ?

Oui, 100 requêtes par minute et par clé. La limite et le nombre restant sont renvoyés dans les en-têtes de réponse.

Existe-t-il un SDK ?

Un SDK TypeScript typé, un serveur MCP pour les clients IA, et des paquets gratuits PHP, Laravel et WordPress. La spécification OpenAPI est servie par l'API pour tout autre langage.

Développez avec API de publication dès aujourd'hui

Le démarrage est gratuit et l'API complète est incluse. Créez une clé et faites votre premier appel en quelques minutes.

Obtenir votre clé API