https://gateway.streamfizz.live/apiMet à jour la confidentialité d'un live.
| Nom | Type | Description |
|---|---|---|
id* | ID! | Identifiant unique du live. |
type | ConfidentialityType | Type de confidentialité (PUBLIC ou PRIVATE). |
hasPublicPageAvailable | Boolean | Autorise l'accès à la page publique. |
hasRollAvailable | Boolean | Autorise les annonces (rolls) sur le contenu. |
hasEmbedAvailable | Boolean | Autorise l'intégration en iframe (embed). |
embedAllowedDomains | [String!] | Liste des domaines autorisés pour l'intégration embed. Chaque entrée est
ramenée à son nom d'hôte avant d'être enregistrée (protocole, |
isPasswordProtected | Boolean | Active la protection par mot de passe. |
password | String | Mot de passe pour accéder au contenu (requis si isPasswordProtected est true ; un mot de passe fait uniquement d'espaces compte comme absent). Un contenu créé hérite du mot de passe des préférences du compte seulement si ces préférences activent la protection par mot de passe. |
allowPreviewContent | Boolean | Autorise la prévisualisation du contenu avant déverrouillage. |
isIpProtected | Boolean | Active la restriction par adresse IP. |
ips | [String!] | Liste des adresses IP autorisées (requise si isIpProtected est true) : adresses IPv4 ou IPv6 exactes, sans plage CIDR ; les doublons sont ignorés. |
hasPlaylistAvailable | Boolean | Lecture depuis une playlist sur le site public (voir |
hasWebTVAvailable | Boolean | Lecture depuis une WebTV sur le site public (voir |
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 |
INPUT_VALIDATION_ERROR | Validation failed: password: Password is required when isPasswordProtected is true | La protection par mot de passe serait active sans mot de passe : |
Validation failed: ips: IPs are required when isIpProtected is true | La protection par IP serait active sans aucune adresse : | |
Validation failed: ips.{index}: Invalid IP address: expected an exact IPv4 or IPv6 address | Une entrée de | |
Validation failed: embedAllowedDomains.{index}: Invalid domain: expected a host name such as example.com | Une entrée de |
60 requêtes par minute par clé API
En cas de dépassement, une erreur 429 Too Many Requests est retournée.