Aller au contenu
twitch.apiv2.0

Référence / Groupes de l'API

twitch.conduits

Conduits : le transport EventSub qui répartit les événements sur plusieurs shards.

Toutes les méthodes de twitch.conduits, avec leurs paramètres, ce qu’elles renvoient et le jeton nécessaire.

twitch.conduits.list(options?): Promise<Conduit[]>

Liste les conduits de votre application.

Jeton : application.

Cette méthode ne prend aucun paramètre propre.

options : Options de requête pour cet appel : as, token, signal, timeout, retries.

Promise<Conduit[]>

Champs de Conduit
NomTypeDescription
idstringIdentifiant du conduit.
shard_countnumberNombre de shards du conduit.
const conduits = await twitch.conduits.list();

Référence Twitch

twitch.conduits.create(params, options?): Promise<Conduit>

Crée un conduit avec le nombre de shards donné.

Jeton : application.

NomTypeDescription
shard_count requisnumberNombre de shards à créer.

options : Options de requête pour cet appel : as, token, signal, timeout, retries.

Promise<Conduit>

Champs de Conduit
NomTypeDescription
idstringIdentifiant du conduit.
shard_countnumberNombre de shards du conduit.
const conduit = await twitch.conduits.create({ shard_count: 2 });

Référence Twitch

twitch.conduits.update(params, options?): Promise<Conduit>

Change le nombre de shards d’un conduit.

Jeton : application.

NomTypeDescription
id requisstringIdentifiant du conduit.
shard_count requisnumberNouveau nombre de shards. Le réduire supprime les shards aux identifiants les plus élevés.

options : Options de requête pour cet appel : as, token, signal, timeout, retries.

Promise<Conduit>

Champs de Conduit
NomTypeDescription
idstringIdentifiant du conduit.
shard_countnumberNombre de shards du conduit.
await twitch.conduits.update({ id: conduit.id, shard_count: 5 });

Référence Twitch

twitch.conduits.delete(id, options?): Promise<void>

Supprime un conduit. Ses abonnements s’arrêtent peu après.

Jeton : application.

id : string

options : Options de requête pour cet appel : as, token, signal, timeout, retries.

Promise<void>

await twitch.conduits.delete(conduit.id);

Référence Twitch

twitch.conduits.shards(params, options?): Paginator<ConduitShard>

Liste les shards d’un conduit et l’endroit où chacun livre les événements.

Jeton : application.

NomTypeDescription
conduit_id requisstringIdentifiant du conduit.
statusConduitShardStatusUniquement les shards dans cet état.
afterstringCurseur de la page suivante.

options : Options de requête pour cet appel : as, token, signal, timeout, retries.

Paginator<ConduitShard>

Champs de ConduitShard
NomTypeDescription
idstringIdentifiant du shard : son indice, à partir de "0".
statusConduitShardStatusÉtat actuel du shard.
transportConduitShardTransportEndroit où le shard livre les événements.
const shards = await twitch.conduits.shards({ conduit_id: conduit.id }).all();

Référence Twitch

twitch.conduits.updateShards(params, options?): Promise<UpdateConduitShardsResult>

Dirige des shards vers un callback de webhook ou une session WebSocket. Les shards qui n’ont pas pu être mis à jour sont signalés dans errors au lieu de lever une erreur.

Jeton : application.

NomTypeDescription
conduit_id requisstringIdentifiant du conduit.
shards requisreadonly { id: string; transport: ConduitShardTransportInput; }[]Shards à mettre à jour. En nombre quelconque : les longues listes sont découpées pour vous.

options : Options de requête pour cet appel : as, token, signal, timeout, retries.

Promise<UpdateConduitShardsResult>

Champs de UpdateConduitShardsResult
NomTypeDescription
dataConduitShard[]Shards mis à jour.
errorsConduitShardError[]Shards qui n’ont pas pu être mis à jour.
const { errors } = await twitch.conduits.updateShards({
conduit_id: conduit.id,
shards: [{ id: "0", transport: { method: "websocket", session_id } }],
});

Référence Twitch