WebSocket & Socket.IO API

Kalau kamu ingin membuat sendiri sesuatu di atas event live TikTok — overlay buatan sendiri, integrasi ke perangkat lain, atau alat internal — IndoFinity membuka dua jalur lokal yang bisa kamu sambungi.

Hanya tersedia di aplikasi desktop

Kedua endpoint ini berjalan di localhost, disediakan oleh aplikasi desktop IndoFinity. Membukanya dari browser tidak akan berhasil karena tidak ada yang mendengarkan di port itu.

Unduh aplikasi desktopnya lewat menu Download Aplikasi.

Dua endpoint

Jalur	Endpoint
WebSocket	ws://localhost:62024
Socket.IO	http://localhost:62025

Keduanya mengirim data yang sama — pilih yang sesuai dengan alat yang kamu pakai. Status online/offline masing-masing terlihat langsung di menu WebSocket API di dashboard.

Format data

Semua pesan berbentuk JSON dengan struktur yang sama:

{
    "event": "chat",
    "data": {}
}

Kunci	Isi
event	Nama event dari TikTok, mengikuti dokumentasi TikTok-Live-Connector
data	Objek berisi informasi event tersebut, sesuai struktur event yang bersangkutan

Event donasi

Selain event TikTok, tujuh event donasi ikut dikirim:

saweria · sociabuzz · trakteer · tako · bagibagi · sibagi · tiptap

Contoh: WebSocket

const ws = new WebSocket('ws://localhost:62024');

ws.onopen = function () {
    console.log('Terhubung ke IndoFinity WebSocket');
};

ws.onmessage = function (data) {
    try {
        const message = JSON.parse(data.data);
        const { event, data: eventData } = message;

        console.log(`Event: ${event}`);
        console.log('Data:', eventData);

        if (event === 'chat') {
            console.log(`@${eventData.uniqueId}: ${eventData.comment}`);
        }
    } catch (error) {
        console.error('Error parsing message:', error);
    }
};

ws.onclose = function () {
    console.log('Koneksi WebSocket ditutup');
};

ws.onerror = function (err) {
    console.error('WebSocket error:', err);
};

Contoh: Socket.IO

Tambahkan library client-nya lebih dulu:

<script src="https://cdn.socket.io/4.7.5/socket.io.min.js"></script>

Atau lewat Node.js:

npm install socket.io-client

Lalu:

import io from "socket.io-client";

const socket = io('http://localhost:62025');

socket.on('connect', () => {
    console.log('Terhubung ke IndoFinity Socket IO');
});

socket.on('message', (data) => {
    try {
        const { event, data: eventData } = data;

        console.log(`Event: ${event}`);
        console.log('Data:', eventData);

        if (event === 'chat') {
            console.log(`@${eventData.uniqueId}: ${eventData.comment}`);
        }
    } catch (error) {
        console.error('Error parsing message:', error);
    }
});

Uji tanpa menunggu penonton

Menu WebSocket API di dashboard punya panel simulator di atas dokumentasinya. Kamu bisa memicu semua jenis event dari situ dan melihatnya masuk ke aplikasimu — tanpa perlu live sama sekali.

Ini cara tercepat memastikan sambunganmu benar sebelum mengandalkannya saat live.

Masalah umum

Gejala: koneksi ditolak. Aplikasi desktop IndoFinity tidak berjalan, atau kamu mencoba dari browser. Cek status Online/Offline di menu WebSocket API.

Gejala: terhubung tapi tidak ada data masuk. Live TikTok belum terhubung. Sambungan ini meneruskan event yang diterima IndoFinity — kalau tidak ada yang masuk, tidak ada yang diteruskan. Pakai panel simulator untuk memastikan jalurnya sendiri sehat.

Gejala: nama event tidak dikenali. Nama event mengikuti TikTok-Live-Connector, bukan penamaan IndoFinity. Rujuk dokumentasi yang ditautkan di atas.

Lihat juga

• Application Logs