https://gateway.streamfizz.live/apiMet à jour la personnalisation d'une WebTV (style, modules, contenu, SEO, rolls). La WebTV n'a qu'un seul BrandSetting via son template, pas de target nécessaire.
| Nom | Type | Description |
|---|---|---|
id* | ID! | Identifiant unique de la WebTV à personnaliser. |
contentInfoInput | ContentInfoInput | Informations de contenu (titres, descriptions, textes). |
seoInput | SeoInput | Paramètres SEO (slug, meta title, meta description, miniature par URL, indexation). |
styleInput | PersonnalisationStyleInput | Style visuel (couleur d'accentuation, CSS, logo par URL). |
moduleInput | PersonnalisationModuleInput | Modules à afficher (discussion, chapitres, fichiers, etc.). |
rollInput | PersonnalisationRollInput | Configuration des annonces intro et outro. |
WebTV| Nom | Type | Description |
|---|---|---|
id | ID! | - |
title | String | Nom de la WebTV dans l'espace de gestion. N'apparaît pas sur le site public, où le titre affiché est celui de la page d'accueil. |
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 : |
domain | String | - |
contentCount | Int! | Nombre de contenus rattachés à la WebTV, toutes sections confondues. |
rollOption | WebTVRollOption | - |
note | String | - |
bannerKey | String | - |
bannerCdnUrl | String | - |
publicUrl | String | - |
originalPublisher | DeletedUser | - |
accessGroups | [Group!]! | - |
directUsers | [PublicUser!]! | - |
createdAt | DateTime! | - |
updatedAt | DateTime! | - |
publisher | User! | - |
sections | [WebTVSection!]! | - |
account | Account | - |
relatedTags | [Tag] | - |
relatedCategories | [Category] | - |
about | WebTVAbout | - |
template | WebTVTemplate | - |
groups | [WebTVGroup!]! | - |
links | [WebTVLink] | - |
contactPage | WebTVContactPage | - |
seo | SEO | - |
menu | [WebTVMenu!]! | - |
preRoll | RollPreset | - |
postRoll | RollPreset | - |
tracking | WebTVTracking | Outils de mesure d'audience branchés sur le site. |
confidentiality | Confidentiality | - |
privacy | Privacy | Inscription des spectateurs. |
| 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 | WebTV '{id}' has not been found | La WebTV n'existe pas ou n'appartient pas au compte |
RollPreset '{id}' has not been found |
| |
INPUT_VALIDATION_ERROR | Validation failed: contentInfoInput.startsAt: startsAt must use the HH:MM:SS format (e.g. 00:00:15) |
|
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.