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.
Paramètres
Section intitulée « Paramètres »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
| Nom | Type | Description |
|---|---|---|
id | string | Identifiant du conduit. |
shard_count | number | Nombre de shards du conduit. |
const conduits = await twitch.conduits.list();twitch.conduits.create(params, options?): Promise<Conduit>Crée un conduit avec le nombre de shards donné.
Jeton : application.
Paramètres
Section intitulée « Paramètres »| Nom | Type | Description |
|---|---|---|
shard_count requis | number | Nombre de shards à créer. |
options : Options de requête pour cet appel : as, token, signal, timeout, retries.
Promise<Conduit>
Champs de Conduit
| Nom | Type | Description |
|---|---|---|
id | string | Identifiant du conduit. |
shard_count | number | Nombre de shards du conduit. |
const conduit = await twitch.conduits.create({ shard_count: 2 });twitch.conduits.update(params, options?): Promise<Conduit>Change le nombre de shards d’un conduit.
Jeton : application.
Paramètres
Section intitulée « Paramètres »| Nom | Type | Description |
|---|---|---|
id requis | string | Identifiant du conduit. |
shard_count requis | number | Nouveau 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
| Nom | Type | Description |
|---|---|---|
id | string | Identifiant du conduit. |
shard_count | number | Nombre de shards du conduit. |
await twitch.conduits.update({ id: conduit.id, shard_count: 5 });twitch.conduits.delete(id, options?): Promise<void>Supprime un conduit. Ses abonnements s’arrêtent peu après.
Jeton : application.
Paramètres
Section intitulée « Paramètres »id : string
options : Options de requête pour cet appel : as, token, signal, timeout, retries.
Promise<void>
await twitch.conduits.delete(conduit.id);twitch.conduits.shards(params, options?): Paginator<ConduitShard>Liste les shards d’un conduit et l’endroit où chacun livre les événements.
Jeton : application.
Paramètres
Section intitulée « Paramètres »| Nom | Type | Description |
|---|---|---|
conduit_id requis | string | Identifiant du conduit. |
status | ConduitShardStatus | Uniquement les shards dans cet état. |
after | string | Curseur de la page suivante. |
options : Options de requête pour cet appel : as, token, signal, timeout, retries.
Paginator<ConduitShard>
Champs de ConduitShard
| Nom | Type | Description |
|---|---|---|
id | string | Identifiant du shard : son indice, à partir de "0". |
status | ConduitShardStatus | État actuel du shard. |
transport | ConduitShardTransport | Endroit où le shard livre les événements. |
const shards = await twitch.conduits.shards({ conduit_id: conduit.id }).all();updateShards
Section intitulée « updateShards »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.
Paramètres
Section intitulée « Paramètres »| Nom | Type | Description |
|---|---|---|
conduit_id requis | string | Identifiant du conduit. |
shards requis | readonly { 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
| Nom | Type | Description |
|---|---|---|
data | ConduitShard[] | Shards mis à jour. |
errors | ConduitShardError[] | 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 } }],});