API Tutorial
Comment publier sur X par API
Pour publier sur X par API, connecte le compte X 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 X et renvoie l'ID du post.
L'API propre à X 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 X (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 X
Dans le tableau de bord, clique sur Connecter et choisis X. 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 X. La connexion reçoit un `connectionId` stable auquel tu fais référence dans chaque appel.
Appeler posts_create pour publier sur X
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 X (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 X 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 X
Commencer gratuitementFAQ
Ai-je besoin d'une application développeur X pour publier par API ?
Non. Modiva possède l'application X 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 X à 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 X dès que tu ajoutes ta clé MCP Modiva.