API Tutorial
Comment planifier des publications Instagram par API
Pour planifier des publications Instagram par API, connecte Instagram via Modiva puis appelle `posts_schedule` avec ton contenu et un horodatage `publish_at` — Modiva le met en file d'attente et le publie automatiquement à ce moment-là sur Instagram.
Planifier, c'est enregistrer une publication et la diffuser plus tard de façon fiable — quelque chose que l'API de Instagram te laisse entièrement gérer. Modiva exploite la file d'attente, réessaie en cas d'erreurs temporaires de Instagram et expose un unique outil `posts_schedule` qui fonctionne à l'identique sur chaque plateforme.
Étape par étape
Créer un compte Modiva et une clé MCP
Inscris-toi gratuitement et génère une clé MCP (`mk_live_…`) dans le tableau de bord. La même clé authentifie à la fois le serveur MCP hébergé (pour les agents IA) et l'API REST (pour ton backend), si bien que tu ne gères qu'un seul identifiant d'accès.
Connecter ton compte Instagram
Dans le tableau de bord, clique sur Connecter et choisis Instagram. Modiva exécute le flux OAuth et demande les scopes appropriés à ta place, puis stocke les tokens d'accès et de rafraîchissement dans un coffre chiffré et les maintient à jour — tu ne manipules jamais les identifiants d'API bruts de Instagram. La connexion reçoit un `connectionId` stable auquel tu fais référence dans chaque appel.
Appeler posts_schedule avec une heure publish_at
Appelle `posts_schedule` avec l'ID de connexion, ton contenu et un horodatage `publish_at` au format ISO. Modiva enregistre la tâche et publie à ce moment-là sur Instagram, en prenant en charge le rafraîchissement des tokens et les réessais sans ton propre cron.
Trouver le meilleur moment et regrouper un calendrier
Appelle `analytics_best_time_to_post` pour choisir un créneau, puis planifie toute une semaine en boucle. Via MCP, un agent IA peut planifier et mettre en file d'attente un calendrier de contenu Instagram complet à partir d'un seul prompt.
Exemple de requête
Appelez l'outil posts_schedule via l'API REST de Modiva. Le même outil est disponible pour les agents IA sur le serveur MCP à l'adresse https://mcp.modiva.ai/v1.
curl -X POST https://api.modiva.ai/v1/tools/invoke \
-H "Authorization: Bearer mk_live_…" \
-H "Content-Type: application/json" \
-d '{
"tool": "posts_schedule",
"connectionId": "conn_…",
"args": { "text": "Weekly roundup is live", "publish_at": "2026-07-01T15:00:00Z" }
}'Essayez-le avec Instagram
Commencer gratuitementFAQ
Est-ce Modiva ou moi qui exploite le planificateur ?
Modiva. Dès que tu appelles `posts_schedule`, Modiva enregistre la tâche et publie à l'heure voulue sur Instagram — tu n'as besoin ni de ta propre file d'attente ni d'un cron.
Puis-je planifier la même publication pour plusieurs plateformes ?
Oui — transmets plusieurs ID de connexion (ou utilise `posts_cross_post`) et Modiva planifie la publication pour Instagram et chaque autre plateforme, adaptée au format de chacune.