https://gateway.streamfizz.live/apiRenvoie l'e-mail d'invitation, quel que soit l'état du précédent, avec le message personnalisé enregistré pour la langue du spectateur. invitationStatus repasse à PENDING. Sur un contenu PUBLIC, aucun e-mail n'est envoyé et invitationStatus reste inchangé.
Les spectateurs révoqués sont ignorés : ils ne reçoivent rien, mais figurent dans la réponse.
| Nom | Type | Description |
|---|---|---|
mediaId | ID | Média dont les spectateurs sont gérés. |
liveId | ID | Direct dont les spectateurs sont gérés. |
playlistId | ID | Playlist dont les spectateurs sont gérés. |
webTVId | ID | WebTV dont les spectateurs sont gérés. |
ids* | [ID!]! | Identifiants des lignes renvoyées par |
[VisitorAccess!]!| Nom | Type | Description |
|---|---|---|
id | ID! | - |
status | VisitorAccessStatus! | Décision d'accès. Seul |
email | String! | E-mail invité ou inscrit, en minuscules. |
invitationStatus | VisitorInvitationStatus | État du dernier e-mail d'invitation. |
locale | Locale! | Langue des e-mails envoyés à ce spectateur. |
lastLogin | DateTime | Dernière visite du contenu. |
createdAt | DateTime! | Date de l'invitation ou de la demande d'accès. |
updatedAt | DateTime! | - |
visitor | Visitor | Profil du spectateur. |
L'accès est accordé tout de suite, l'e-mail part en arrière-plan : invitationStatus revient en PENDING, puis passe à SENT ou FAILED. Pour retrouver les échecs, filtrez la liste, puis relancez-les avec inviteVisitors.
{
getVisitors(
mediaId: "MEDIA_ID"
filter: { invitationStatus: [FAILED] }
) {
totalCount
visitors {
id
email
}
}
}| 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: ids: {message} |
| |
NOT_FOUND | {Type} '{id}' has not been found | L'identifiant ne désigne aucun contenu de ce type ( |
This content has no privacy settings | Le contenu existe, mais son inscription n'a jamais été configurée. La configurer d'abord avec | |
One or more visitor accesses have not been found | Un des | |
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 d'écriture 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.