APIhttps://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 | You are not authorized to perform this action | Clé API manquante, invalide, expirée ou révoquée. La réponse porte un code HTTP 200 : c'est le corps GraphQL qui signale l'échec. |
INPUT_VALIDATION_ERROR | Validation failed: {field}: {message} | Un ou plusieurs champs sont invalides (format, longueur, protocole…). Le détail est dans extensions.fieldErrors[]. |
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 | Media '{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.