https://gateway.streamfizz.live/apiMet à jour un direct existant. Seuls les champs fournis seront modifiés. Passer explicitement null sur note ou waitingThumbUrl efface la valeur ; un champ absent reste inchangé.
| Nom | Type | Description |
|---|---|---|
id* | ID! | Identifiant unique du direct à mettre à jour. |
title | String | Titre du direct, non vide, 200 caractères au plus : un titre ne peut pas être effacé. |
note | String | Note interne sur le direct, 5 000 caractères au plus. |
scheduledStartAt | DateTime | Date et heure de début programmées (format : voir |
shouldShowCountdown | Boolean | Affiche un compte à rebours avant le direct. |
deltaChapter | Int | Décalage global en secondes appliqué aux points de chapitre à la lecture,
pour rattraper la latence d'encodage et de diffusion. Entier de 0 à 3 600
(1 h) ; |
hasReplay | Boolean | Active la mise à disposition d'un replay après le direct. |
hasDVR | Boolean | Active le DVR (rembobinage pendant le direct). |
hasVOD | Boolean | Active la génération d'un enregistrement VOD. |
isRocket | Boolean | Sélectionne le moteur de streaming Roquette (nécessite un compte habilité). |
broadcastLocation | BroadcastLocation | Région depuis laquelle le direct est diffusé. Sans effet sur un direct
Roquette (argument ignoré, moteur résultant de l'appel). Sur un direct Wowza
(moteur déprécié), modifiable uniquement au statut |
waitingThumbUrl | String | URL publique de la vignette d'attente (JPEG ou PNG). L'image sera téléchargée et stockée automatiquement. |
subtitleConfig | LiveSubtitleConfigInput | Configuration du sous-titrage en direct, appliquée par le moteur Roquette. Acceptée sur un direct Wowza (moteur déprécié) sans y produire de sous-titres : elle est prise en compte si le direct passe sur Roquette. |
Live| Nom | Type | Description |
|---|---|---|
id | ID! | Identifiant unique du direct. |
title | String! | Titre du direct. |
status | LiveStatusType! | Statut courant du direct. Valeurs possibles :
|
myCapability | AuthzCapability! | Ce que l'appelant a le droit de faire sur ce contenu, compte tenu de ses
groupes et de ses accès directs : |
note | String | Note interne sur le direct. |
duration | Int | Durée du direct en secondes. |
currentAudienceDéprécié | Int | Audience temps réel : nombre de spectateurs uniques sur la dernière minute glissante. Calculé à la volée : spectateurs du direct en Running, spectateurs en attente en Preview, null sinon. Déprécié : Utiliser getLiveAnalytics(id: ...).realtime.currentViewers |
maxPeakViewersDéprécié | Int | Pic de spectateurs uniques atteint pendant le direct, figé à la fin du direct. À afficher une fois le direct terminé. Déprécié : Utiliser getLiveAnalytics(id: ...).realtime.peakConcurrentViewers |
fallbackAcknowledged | Boolean | Indique si le fallback a été acquitté par l'utilisateur. |
publicUrl | String | URL de la page de lecture publique. |
publicEmbedUrl | String | URL d'intégration (embed) publique. |
shouldShowCountdown | Boolean | Affiche un compte à rebours avant le direct. |
isRocket | Boolean! | Indique si le direct est diffusé via Roquette (sinon Wowza legacy). |
activeSource | RelaySource | Source d'ingest actuellement diffusée — Roquette uniquement. |
fallbackActive | Boolean | Indique si le fallback est actuellement actif. |
waitingThumbKey | String | Clé S3 de la vignette d'attente. |
waitingThumbCdnUrl | String | URL CDN de la vignette d'attente. |
thumbnailVttCdnUrl | String | URL CDN du VTT des vignettes de scrubbing (live Rocket uniquement, sinon null). |
deltaChapter | Int | Décalage en secondes appliqué aux points de chapitre à la lecture, pour rattraper la latence d'encodage et de diffusion. |
accessGroups | [Group!]! | Groupes ayant accès à ce direct. |
directUsers | [PublicUser!]! | Utilisateurs ayant un accès direct à ce direct. |
publisher | User | Utilisateur ayant créé le direct. |
account | Account | Compte propriétaire du direct. |
createdAt | DateTime | Date de création du direct. |
updatedAt | DateTime | Date de dernière modification du direct. |
scheduledStartAt | DateTime | Date de début programmée, informative. À la création, vaut par défaut la prochaine demi-heure ; modifiable ou effaçable par updateLive. |
lifecycle | LiveLifecycle | Dates réelles du cycle de vie (démarrages, fin, échéances d'arrêt auto). |
ingest | LiveIngest | Credentials d'ingest (RTMP / SRT). |
playback | LivePlayback | URLs de lecture du direct (HLS). |
recording | LiveRecording | Options d'enregistrement et de relecture (DVR, VOD, replay). |
relaySources | [RelaySourceInfo!] | État de chaque source d'ingest (primary / backup) — Roquette uniquement. |
transcoderDéprécié | TranscoderTMP | Transcoder Wowza associé (legacy). Déprécié : Transcoder Wowza legacy, sera retiré. |
transcoderInfos | TranscoderInfos | Infos temps réel du transcoder (bitrate, résolution, cibles). |
subtitles | LiveSubtitles | Configuration du sous-titrage en direct — Roquette uniquement. |
chapters | [Chapter] | Chapitres associés au direct. |
files | [File!] | Fichiers joints au direct. |
discussion | Discussion | Discussion (chat) associée au direct. |
liveDestinations | [LiveDestination] | Destinations de simulcast (réémission RTMP vers des plateformes tierces). |
relatedTags | [Tag] | Tags rattachés. |
relatedCategories | [Category] | Catégories rattachées. |
pageSetting | BrandSetting | Paramètres de personnalisation de la page de lecture. |
embedSetting | BrandSetting | Paramètres de personnalisation de l'embed. |
seo | SEO | Paramètres SEO de la page de lecture. |
confidentiality | Confidentiality | Niveau de confidentialité (nouveau modèle). |
privacy | Privacy | Inscription des spectateurs. |
playlists | PlaylistConnection | Playlists contenant ce direct. |
webTVs | WebTVConnection | WebTVs contenant ce direct. |
originalPublisher | DeletedUser | - |
| 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 direct n'existe pas, ou il a été supprimé (statut Archived) : aucune écriture n'est possible sur un direct archivé, même réponse que |
INVALID_LIVE_STATUS | Cannot {action} a live in status "{status}". Allowed statuses: {allowedStatuses}. | L'action n'est pas autorisée dans le statut actuel du live. Actions et statuts autorisés :
|
Cannot update subtitle config once the live has started |
| |
Cannot change broadcastLocation of a live in status "{status}". Allowed statuses: Scheduled. |
| |
INPUT_VALIDATION_ERROR | Validation failed: subtitleConfig.sourceLanguages: At least one source language is required when subtitles are enabled | Les sous-titres seraient activés sans langue parlée : |
Validation failed: scheduledStartAt: Invalid date: expected ISO 8601, e.g. 2026-09-02T14:30:00Z |
| |
Validation failed: scheduledStartAt: scheduledStartAt must be at most one year from now |
| |
Validation failed: deltaChapter: deltaChapter must be at most 3600 seconds (1 hour) |
| |
Validation failed: {field}: URL must point to a public host | Une des URL fournies ( | |
LIVE_NOT_PLUGGED | This live has no Wowza transcoder yet: broadcastLocation cannot be changed. |
|
URL_UNREACHABLE | Unable to reach URL | Une des URL fournies ( |
URL_ACCESS_DENIED | Cannot access URL | Une des URL fournies répond mais refuse l'accès ou ne trouve pas la ressource (403, 404), ou enchaîne plus de cinq redirections. |
DOWNLOAD_FAILED | Source too large: {size}b (max {max}b) | Le fichier dépasse 20 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_MIME_TYPE | Unsupported image type: {mimeType}. Only JPEG and PNG are accepted. | Le fichier téléchargé n'est pas une image JPEG ou PNG. |
LANGUAGE_NOT_TRANSCRIBABLE | Language '{language}' does not support Transcribe | Une des langues de |
LANGUAGE_NOT_TRANSLATABLE | Language '{language}' does not support TranslateLive | Une des langues de |
60 requêtes par minute par clé API
En cas de dépassement, une erreur 429 Too Many Requests est retournée.