https://gateway.streamfizz.live/apiImporte des points de chapitre depuis un fichier CSV.
Huit colonnes sont attendues, dans cet ordre : numéro de ligne (ignoré),
intitulé, position en secondes, visibilité (Oui ou true), style
(1, 2, 3 ou Large, Medium, Small), intervenant, lien,
libellé du lien. Une ligne d'en-tête est attendue, et le séparateur — virgule
ou point-virgule — est détecté automatiquement.
Une position vide vaut « chapitre non pointé » ; 0 vaut « au tout début ».
La mutation renvoie tous les chapitres du contenu après import, pas seulement ceux que le fichier vient de créer.
| Nom | Type | Description |
|---|---|---|
mediaId | ID | Média auquel rattacher les chapitres. |
liveId | ID | Direct auquel rattacher les chapitres. |
url* | String! | URL publique du fichier .csv, 5 Mo au plus. |
shouldReplace | Boolean= false | Remplace les chapitres existants au lieu de les compléter. |
[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 |
INPUT_VALIDATION_ERROR | Validation failed: {field}: URL must point to a public host |
|
URL_UNREACHABLE | Unable to reach URL |
|
URL_ACCESS_DENIED | Cannot access URL |
|
DOWNLOAD_FAILED | Source too large: {size}b (max {max}b) | Le fichier dépasse 5 Mo. Le téléchargement s'interrompt dès que la limite est franchie et rien n'est conservé. Quand le serveur distant n'annonce pas la taille, le message devient |
INVALID_CSV_FORMAT | URL must point to a .csv file | L'URL ne pointe pas vers un fichier .csv, ou le fichier ne produit aucune ligne exploitable. Aucun chapitre n'est créé. |
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.