https://gateway.streamfizz.live/apiMet à jour une playlist existante. Seuls les champs fournis sont modifiés. Passer explicitement null sur note, waitingThumbUrl ou description efface la valeur ; un champ absent reste inchangé.
| Nom | Type | Description |
|---|---|---|
id* | ID! | Identifiant unique de la playlist. |
title | String | Titre de la playlist, non vide, 200 caractères au plus. |
description | Json | Description riche de la playlist, au format d'un document
Lexical — voir le scalaire |
hasUniqueChapterFeed | Boolean | Utilise un fil de chapitres unique pour l'ensemble de la playlist. |
rollOption | PlaylistRollOption | Politique d'annonces appliquée à la playlist. |
note | String | Note interne, jamais affichée sur les pages publiques. |
waitingThumbUrl | String | URL publique de la vignette (JPEG ou PNG). L'image sera téléchargée et stockée automatiquement. |
Playlist| Nom | Type | Description |
|---|---|---|
id | ID! | - |
title | String! | - |
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 : |
contentCount | Int | - |
mediaCount | Int | - |
liveCount | Int | - |
hasUniqueChapterFeed | Boolean | - |
waitingThumbKey | String | - |
waitingThumbCdnUrl | String | - |
rollOption | PlaylistRollOption | - |
note | String | - |
publicUrl | String | - |
publicEmbedUrl | String | - |
accessGroups | [Group!]! | - |
directUsers | [PublicUser!]! | - |
description | Json | - |
createdAt | DateTime! | - |
publisher | User! | - |
account | Account | - |
pageSetting | BrandSetting | - |
embedSetting | BrandSetting | - |
relatedTags | [Tag] | - |
relatedCategories | [Category] | - |
playlistContents | PlaylistContentConnection | Contenus de la playlist, dans l'ordre de lecture ( |
preRoll | RollPreset | - |
postRoll | RollPreset | - |
seo | SEO | - |
smartSections | [WebTVSmartSection] | - |
confidentiality | Confidentiality | - |
privacy | Privacy | Inscription des spectateurs. |
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 | Playlist '{id}' has not been found | La playlist n'existe pas ou n'appartient pas au compte |
INPUT_VALIDATION_ERROR | Validation failed: {field}: URL must point to a public host | Une des URL fournies ( |
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. |
60 requêtes par minute par clé API
En cas de dépassement, une erreur 429 Too Many Requests est retournée.