API Tutorial
Comment publier sur Pinterest par API
Pour publier sur Pinterest par API, connecte le compte Pinterest via Modiva (qui gère OAuth et les scopes), puis appelle l'outil `posts_create` avec ton texte et tes médias — Modiva le publie sur Pinterest et renvoie l'ID du post.
L'API propre à Pinterest exige une revue d'application, la gestion d'OAuth et les bonnes autorisations de publication avant que tu puisses ne serait-ce que poster une mise à jour. Modiva s'occupe de tout cela pour toi et expose un unique outil `posts_create` qui publie sur Pinterest (et sur toute autre plateforme connectée) de la même manière.
É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_create pour publier sur Pinterest
Appelle l'outil `posts_create` avec l'ID de connexion et ton contenu. Modiva valide la charge utile par rapport aux règles de format de Pinterest (longueur, types de médias, ratios d'aspect) et publie immédiatement, en renvoyant l'ID et l'URL du post en direct.
Aller plus loin — planifier, cross-poster, automatiser
Le même appel pilote un agent IA via MCP : pointe Claude ou Cursor vers `https://mcp.modiva.ai/v1` et il peut publier sur Pinterest en ton nom. Remplace `posts_create` par `posts_schedule` pour le mettre en file d'attente, ou `posts_cross_post` pour diffuser un même contenu sur toutes les plateformes d'un coup.
Exemple de requête
Appelez l'outil posts_create 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_create",
"connectionId": "conn_…",
"args": { "text": "Shipped via Modiva 🚀" }
}'Essayez-le avec Pinterest
Commencer gratuitementFAQ
Ai-je besoin d'une application développeur Pinterest pour publier par API ?
Non. Modiva possède l'application Pinterest vérifiée et prend en charge OAuth, si bien que tu te connectes en un clic et tu démarres — pas de revue d'application, pas de bidouillage de scopes.
Un agent IA peut-il publier sur Pinterest à ma place ?
Oui. Le même outil `posts_create` est exposé via le Model Context Protocol, si bien que n'importe quel client MCP (Claude, Cursor, etc.) peut publier sur Pinterest dès que tu ajoutes ta clé MCP Modiva.