APIhttps://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. |
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 | 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 |
URL_UNREACHABLE | Unable to reach URL | Impossible de se connecter au serveur (DNS, timeout, connexion refusée) |
URL_ACCESS_DENIED | Cannot access URL | Accès refusé ou ressource non trouvée (403, 404) |
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 |
|
60 requêtes par minute par clé API
En cas de dépassement, une erreur 429 Too Many Requests est retournée.