https://gateway.streamfizz.live/apiPointe un chapitre à l'instant présent, pendant un direct. La position est
calculée par le serveur depuis le début effectif de la diffusion : le client
n'a pas d'horodatage à fournir. La notification temps réel envoyée aux
lecteurs est retardée du décalage configuré sur le direct
(deltaChapter), afin que le marqueur apparaisse au spectateur en même
temps que la séquence correspondante.
Réservée au direct, et seulement pendant qu'il diffuse. Pour un média, ou
pour corriger une position après coup, utiliser updateChapter(startsAt:).
| Nom | Type | Description |
|---|---|---|
liveId* | ID! | Direct auquel le chapitre est rattaché. |
chapterId* | ID! | Identifiant du chapitre à pointer. |
Chapter| Nom | Type | Description |
|---|---|---|
id | ID! | - |
title | String! | Intitulé affiché dans le sommaire du lecteur. |
order | Int! | Rang dans le sommaire, à partir de 1, sans trou. |
startsAt | Float | Position temporelle en secondes depuis le début du contenu. Vaut null pour un chapitre non encore pointé — cas courant sur un direct, où les points sont posés au fil de la diffusion. |
isVisible | Boolean! | Visibilité du point pour les spectateurs. |
speaker | String | Intervenant associé au chapitre. |
url | String | Lien affiché avec le chapitre. |
urlTitle | String | Libellé du lien. À défaut, l'URL est affichée telle quelle. |
style | ChapterStyle | Densité d'affichage du point. |
| Code | Message | Description |
|---|---|---|
UNAUTHENTICATED | Invalid or expired API key | Clé API manquante ( |
API_ADDON_REQUIRED | This account does not have the API addon | La clé est valide mais le compte n'a pas l'option API. La réponse porte un code HTTP 403 ; la requête n'est pas exécutée. |
INPUT_VALIDATION_ERROR | Validation failed: {field}: {message} | Un ou plusieurs champs sont invalides (format, longueur, protocole…). Le détail est dans extensions.fieldErrors[]. Tout argument texte qui n'est pas de l'Unicode valide — caractère NUL ( |
GRAPHQL_VALIDATION_FAILED | Query depth limit of 10 exceeded, found {depth}. | Le document ne respecte pas le schéma : champ ou argument inconnu, valeur écrite en dur dans la requête qui n'a pas le type attendu (valeur d'enum inexistante…), ou limite par requête dépassée (profondeur, coût, alias, directives — voir Rate Limiting). La réponse porte un code HTTP 400 ; rien n'est exécuté. |
BAD_USER_INPUT | Variable "$name" got invalid value {value}; {reason} | Une variable ( |
INTERNAL_SERVER_ERROR | Internal server error | Erreur interne du serveur. Le message est volontairement générique : le détail est journalisé côté Streamfizz, jamais renvoyé. |
| Code | Message | Description |
|---|---|---|
NOT_FOUND | Live '{id}' has not been found | Le |
Chapter '{id}' is not attached to this content | Le chapitre n'existe pas, ou il n'est pas rattaché au contenu désigné. Fournir le | |
INVALID_LIVE_STATUS | Chapters can only be marked while the live is running | Le direct ne diffuse pas : un chapitre ne se pointe que pendant la diffusion. |
60 requêtes par minute par clé API
En cas de dépassement, une erreur 429 Too Many Requests est retournée.