Migration en une étape

Passe de TikTok-Live-Connector à TikTool en quelques secondes

Tu utilises déjà tiktok-live-connector ? Passe à l'API TikTool gérée en modifiant une seule ligne d'import. Mêmes noms d'événements, mêmes méthodes, aucun changement de code.

1

Installe le SDK

npm install @tiktool/live
2

Modifie une ligne d'import

-const { WebcastPushConnection } = require('tiktok-live-connector');
+const { WebcastPushConnection } = require('@tiktool/live');
3

Utilise ta clé API TikTools

-signApiKey: 'EULER_API_KEY'
+signApiKey: 'TIKTOOL_API_KEY'

Obtiens une clé gratuite sur tik.tools - sans carte bancaire.

✅
C'est tout. Tous tes gestionnaires d'événements existants fonctionnent à l'identique - chat, gift, member, roomUser, like, follow, share, emote, linkMicBattle, linkMicArmies, questionNew, getState(), connect(), disconnect().

Exemple complet fonctionnel

Ce code fonctionne à l'identique avec tiktok-live-connector et @tiktool/live. Seul l'import change.

// Before: const { WebcastPushConnection } = require('tiktok-live-connector');
const { WebcastPushConnection } = require('@tiktool/live');

const connection = new WebcastPushConnection('username', {
  signApiKey: 'YOUR_TIKTOOL_API_KEY',
});

connection.on('chat', data => {
  console.log(`${data.user.uniqueId}: ${data.comment}`);
});

connection.on('gift', data => {
  console.log(`${data.user.uniqueId} sent ${data.giftName}`);
});

connection.on('roomUser', data => {
  console.log(`Viewers: ${data.viewerCount}`);
});

connection.on('connected', state => {
  console.log('Connected!', connection.getState());
});

connection.connect();

Compatibilité 100 % des noms d'événements

Chaque nom d'événement TTLC fonctionne exactement pareil. Nous déclenchons aussi le nom natif TikTools en même temps.

Nom d'événement TTLCStatutRemarques
chat✓Identique
member✓Identique
gift✓Identique
like✓Identique
follow✓Identique
share✓Identique
subscribe✓Identique
social✓Identique
roomUser✓Alias de roomUserSeq - les deux se déclenchent
questionNew✓Alias de question - les deux se déclenchent
linkMicBattle✓Alias de battle - les deux se déclenchent
linkMicArmies✓Alias de battleArmies - les deux se déclenchent
emote✓Alias de emoteChat - les deux se déclenchent
envelope✓Identique
liveIntro✓Identique
roomPin✓Identique
barrage✓Identique
superFan✓Nouveau dans 2.0.8 - pris en charge
superFanJoin✓Nouveau dans 2.0.8 - pris en charge
superFanBox✓Nouveau dans 2.0.8 - pris en charge
connected✓Identique
disconnected✓Identique
error✓Identique
streamEnd✓Identique
rawData✓Se déclenche avec le payload brut complet de l'événement
websocketConnected✓Se déclenche à l'ouverture du WS

Pourquoi passer à l'API gérée ?

🛡️

Ne casse jamais

TikTok met régulièrement à jour son protocole, ce qui casse les intégrations directes. TikTool gère tous les changements de protocole pour toi - zéro interruption.

⚡

Événements livrés plus vite

Moins de 50 ms de latence par événement grâce à notre infrastructure optimisée. Aucun décodage protobuf de ton côté.

🧩

Zéro dépendance

Pas de protobufjs, pas de ws-client, pas de signature HTTP. Un seul package npm sans aucune dépendance externe.

🔄

Reconnexion automatique

Reconnexion intégrée avec backoff exponentiel. Ta connexion survit aux coupures réseau et aux redémarrages des serveurs TikTok.

📊

Tableau de bord d'utilisation

Suis ton utilisation de l'API, tes connexions WebSocket et ton volume d'événements en temps réel sur tik.tools/dashboard.

💬

Support développeur

Obtiens de l'aide via Discord, par e-mail ou dans le chat de support intégré. Temps de réponse inférieur à 4 heures.

Questions fréquentes

Mes types TypeScript vont-ils encore fonctionner ?

Oui. @tiktool/live fournit des définitions TypeScript complètes pour chaque payload d'événement - chat, gift, roomUser et tous les autres. Si tu utilisais les types maintenus par la communauté TTLC, les nôtres sont plus stricts et suivent le vrai schéma protobuf de TikTok.

Et les options TTLC comme sessionId, processInitialData et requestPollingIntervalMs ?

Les options du constructeur qui contrôlent la connexion - sessionId, requestPollingIntervalMs, enableExtendedGiftInfo et similaires - sont acceptées et transmises. Les options devenues inutiles (comme processInitialData) sont ignorées sans erreur, donc ton objet de config n'a pas besoin d'être nettoyé.

TTLC fonctionne parfois sans clé API. M'en faut-il une pour TikTool ?

Oui - une signApiKey est requise. La clé Sandbox gratuite s'obtient en 30 secondes sur tik.tools/login, sans carte bancaire. Sandbox inclut 5 000 appels API/jour et 3 connexions WebSocket simultanées, de quoi développer et tester.

Que se passe-t-il concrètement quand TikTok met à jour son protocole ?

Avec TTLC, les mises à jour périodiques de l'algorithme de signature et du schéma protobuf de TikTok font cesser de fonctionner la bibliothèque - parfois quelques heures après un déploiement TikTok, sans correctif tant que le mainteneur open source ne l'a pas patchée. Avec TikTool, les mises à jour du protocole sont gérées sur nos serveurs. Ton code ne voit aucun changement ; les événements continuent d'arriver.

Bonus : ce que TTLC n'a pas

🔍

Live Feed Discovery

Recherche et découvre qui est en live sur TikTok en ce moment. Filtre par langue, région et nombre de spectateurs.

🐍

SDK Python

SDK Python complet disponible : pip install tiktok-live-api. Même API, mêmes événements, autre langage.

Prêt à migrer ?

Obtiens une clé API gratuite - sans carte bancaire. L'offre Sandbox inclut 5 000 requêtes/jour et 3 connexions WebSocket simultanées - gratuite, réservée au développement et à l'évaluation.