https://gateway.streamfizz.live/apiSpectateurs d'un contenu, paginés par curseur. Fournir exactement un de mediaId, liveId, playlistId, webTVId.
Les compteurs portent sur tout le contenu ; totalCount suit le filtre et la recherche. Un contenu dont l'inscription n'a jamais été configurée rend une page vide.
| Nom | Type | Description |
|---|---|---|
mediaId | ID | Média dont lister les spectateurs. |
liveId | ID | Direct dont lister les spectateurs. |
playlistId | ID | Playlist dont lister les spectateurs. |
webTVId | ID | WebTV dont lister les spectateurs. |
limit | Int= 20 | Nombre de spectateurs par page, 100 au plus. |
cursor | String | Curseur rendu par |
filter | VisitorAccessFilter | Restreint la liste et |
search | String | Recherche insensible à la casse dans l'e-mail, et dans le prénom et le nom des spectateurs dont le profil est visible. 254 caractères au plus. Restreint la liste et |
sortBy | VisitorSortField= createdAt | Critère de tri. |
VisitorAccessConnection!| Nom | Type | Description |
|---|---|---|
totalCount | Int! | Nombre de spectateurs correspondant au filtre, toutes pages confondues. |
counters | VisitorAccessCounters! | Nombre de spectateurs par statut sur tout le contenu, sans tenir compte du filtre. |
pageInfo | PaginationInfo! |
|
visitors | [VisitorAccess!]! | Spectateurs de la page, dans l'ordre de |
| 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: mediaId: Provide exactly one of mediaId, liveId, playlistId or webTVId | Aucun, ou plusieurs, des arguments |
Validation failed: cursor: Unknown cursor | Le | |
Validation failed: {field}: {message} |
| |
NOT_FOUND | {Type} '{id}' has not been found | L'identifiant ne désigne aucun contenu de ce type ( |
FORBIDDEN | You don't have the permission for this request | Le contenu appartient à un autre compte, ou l'utilisateur de la clé n'a pas le droit de lecture sur lui. Pour une clé qui n'est ni propriétaire ni administrateur du compte, un identifiant inconnu donne aussi cette erreur. |
60 requêtes par minute par clé API
En cas de dépassement, une erreur 429 Too Many Requests est retournée.