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