API Tutorial
Comment planifier des publications Pinterest par API
Pour planifier des publications Pinterest par API, connecte Pinterest 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 Pinterest.
Planifier, c'est enregistrer une publication et la diffuser plus tard de façon fiable — quelque chose que l'API de Pinterest te laisse entièrement gérer. Modiva exploite la file d'attente, réessaie en cas d'erreurs temporaires de Pinterest 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 Pinterest
Dans le tableau de bord, clique sur Connecter et choisis Pinterest. 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 Pinterest. 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 Pinterest, 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 Pinterest 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 Pinterest
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 Pinterest — 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 Pinterest et chaque autre plateforme, adaptée au format de chacune.