https://gateway.streamfizz.live/apiCrée un point de chapitre sur un média ou un direct. Fournir exactement un de
mediaId ou liveId.
| Nom | Type | Description |
|---|---|---|
mediaId | ID | Média auquel rattacher le chapitre. |
liveId | ID | Direct auquel rattacher le chapitre. |
title* | String! | Intitulé affiché dans le sommaire, 255 caractères au plus. |
startsAt | Float | Position en secondes depuis le début du contenu. Omettre pour un chapitre
non pointé, à compléter plus tard. Au plus la durée du média ; tant qu'elle
n'est pas connue (direct, média non encodé), au plus 86 400 (24 h). Au-delà :
|
isVisible | Boolean= true | Visibilité pour les spectateurs. |
style | ChapterStyle= Medium | Densité d'affichage du point. |
speaker | String | Intervenant associé au chapitre, 255 caractères au plus. |
url | String | Lien affiché avec le chapitre. |
urlTitle | String | Libellé du lien, 255 caractères au plus. À défaut, l'URL est affichée telle quelle. |
order | Int | Rang souhaité dans le sommaire. Par défaut, en dernière position. |
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 | {Media|Live} '{id}' has not been found | Le |
CHAPTER_OUT_OF_RANGE | startsAt {startsAt} exceeds the media duration of {duration} seconds |
|
startsAt {startsAt} exceeds 86400 seconds, the maximum allowed while the content duration is unknown | La durée du contenu n'est pas connue (direct, ou média dont l'encodage n'a pas encore mesuré la durée) et |
60 requêtes par minute par clé API
En cas de dépassement, une erreur 429 Too Many Requests est retournée.