https://gateway.streamfizz.live/apiDéfinit le pseudo sous lequel l'utilisateur authentifié publie dans une
discussion. Le pseudo s'applique aussi à ses messages déjà publiés, et vaut
pour le direct comme pour son replay. Omettre pseudo, passer null,
une chaîne vide ou faite d'espaces revient au pseudo par défaut ; le pseudo
effectif se lit dans
Discussion.myModeratorPseudo.
| Nom | Type | Description |
|---|---|---|
discussionId* | ID! | Discussion concernée. |
pseudo | String | Pseudo, 50 caractères au plus. Les caractères de contrôle bidirectionnel (U+202A–U+202E, U+2066–U+2069, U+200E, U+200F, U+061C) sont refusés. |
Discussion| Nom | Type | Description |
|---|---|---|
id | ID! | - |
preset | DiscussionPreset | Mode d'animation de la discussion. Il détermine la présentation côté
lecteur : |
autoPublish | Boolean | Publie les messages sans validation préalable d'un modérateur. |
shouldBlockProfanity | Boolean | Passe au filtre anti-grossièretés, français et anglais, le texte et les
réponses au formulaire de tout message écrit depuis le lecteur. Un message
refusé est enregistré quand même, marqué |
placeholder | String | Texte d'invite affiché au-dessus du formulaire de message. Texte brut, à échapper à l'affichage. |
shouldShowMessages | Boolean | Affiche le fil des messages aux spectateurs. À |
shouldAllowAnswer | Boolean | Autorise les réponses à un message. |
shouldAllowLike | Boolean | Autorise les mentions « j'aime ». |
messagesCount | Int | Nombre total de messages, réponses comprises. |
myModeratorPseudo | String! | Pseudo sous lequel l'utilisateur authentifié publie dans cette discussion : son pseudo de discussion, à défaut son pseudo par défaut, à défaut « Modérateur ». |
mediaId | ID | Média porteur, s'il y en a un. Scalaire et non relation : l'écran de
modération, routé par |
liveId | ID | Direct porteur, s'il y en a un. |
createdAt | DateTime | - |
fields | [MessageField!] | Champs du formulaire d'inscription, dans leur ordre d'affichage. |
messageGroups | [MessageGroup!]! | Groupes de messages de la discussion, dans leur ordre d'affichage, avec le nombre de messages de chacun. Cinq au plus. |
publisher | User | Utilisateur à l'origine de la discussion. |
| 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 | Discussion '{id}' has not been found | La discussion n'existe pas, le contenu qui la porte appartient à un autre compte, ou elle appartient à un direct supprimé (statut Archived) sans replay — tous ces cas renvoient la même erreur. L'identifiant se lit dans |
FORBIDDEN | You don't have the permission for this request | La discussion est dans le compte, mais l'utilisateur de la clé n'a pas le droit de la modérer : un modérateur n'accède qu'aux contenus qui lui sont assignés. |
INPUT_VALIDATION_ERROR | Validation failed: pseudo: {message} |
|
60 requêtes par minute par clé API
En cas de dépassement, une erreur 429 Too Many Requests est retournée.