https://gateway.streamfizz.live/apiListe les WebTV visibles par l'appelant, avec recherche, filtres et pagination (curseur ou numéro de page).
| Nom | Type | Description |
|---|---|---|
query | String | Texte cherché dans le titre et le titre de page, sans tenir compte des
accents ni de la casse. Le texte est découpé en mots — tout ce qui n'est
ni lettre ni chiffre sépare deux mots, |
filters | [ContentFilter!] | Filtres retenus. Une valeur hors du domaine d'un critère à valeurs fermées (STATUS, MEDIA_TYPE, CONFIDENTIALITY, INSCRIPTION, HAS_VOD, HAS_REPLAY) est refusée. Un critère qui ne s'applique pas au type listé (MEDIA_TYPE sur les directs, STATUS sur les médias…) et un filtre sans valeur sont ignorés. |
sortBy | WebTVSortField | Tri appliqué après la pertinence (défaut : createdAt). |
limit | Int= 20 | Nombre maximum d'éléments par page, de 1 à 40 ; au-delà, refusé. |
cursor | String | Curseur : identifiant du dernier élément de la page précédente. Refusé s'il ne désigne aucun contenu accessible de ce type. |
page | Int | Numéro de page, de 0 à 1000 (au-delà, refusé). Ignoré quand un curseur est fourni. |
excludeIds | [ID!] | Identifiants à écarter des résultats. |
WebTVConnection| Nom | Type | Description |
|---|---|---|
totalCount | Int | Nombre total d'éléments, toutes pages confondues. |
pageInfo | PaginationInfo! | Pagination : y a-t-il une suite, et depuis quel curseur. |
webTV | [WebTV!]! | Les éléments de la page courante. |
filterOptions | [ContentFilterOptions!] | Valeurs disponibles pour chaque filtre, avec leur nombre de contenus. |
| 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 |
|---|---|---|
INPUT_VALIDATION_ERROR | Validation failed: excludeIds.{index}: Invalid CUID format | Un des |
Validation failed: limit: limit must be at most 40 |
| |
Validation failed: filters.{index}.values.{index}: Unknown value '{value}' for filter {attribute}. Allowed values: {values} | Une valeur de | |
Validation failed: cursor: Unknown cursor '{cursor}': no accessible item has this id | Le |
60 requêtes par minute par clé API
En cas de dépassement, une erreur 429 Too Many Requests est retournée.