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.
Installe le SDK
npm install @tiktool/liveModifie une ligne d'import
const { WebcastPushConnection } = require('tiktok-live-connector');const { WebcastPushConnection } = require('@tiktool/live');Utilise ta clé API TikTools
signApiKey: 'EULER_API_KEY'signApiKey: 'TIKTOOL_API_KEY'Obtiens une clé gratuite sur tik.tools - sans carte bancaire.
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 TTLC | Statut | Remarques |
|---|---|---|
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.