https://gateway.streamfizz.live/apiMet à jour la configuration d'une discussion. Seuls les champs fournis sont modifiés. La discussion existe dès la création de son média ou de son direct : il n'y a rien à créer au préalable.
| Nom | Type | Description |
|---|---|---|
discussionId* | ID! | Discussion à configurer, telle que rendue par |
preset | DiscussionPreset | Mode d'animation de la discussion. |
autoPublish | Boolean | Publie les messages sans validation préalable d'un modérateur. |
shouldBlockProfanity | Boolean | Refuse à la publication tout message contenant une grossièreté, en français comme en anglais. Le message n'est pas publié, son auteur reçoit une erreur. |
placeholder | String | Texte d'invite affiché au-dessus du formulaire de message, 255 caractères au plus (espaces de début et de fin retirés). |
shouldShowMessages | Boolean | Affiche le fil des messages aux spectateurs. |
shouldAllowAnswer | Boolean | Autorise les réponses à un message. |
shouldAllowLike | Boolean | Autorise les mentions « j'aime ». |
fields | [DiscussionFieldInput!] | Configuration des champs du formulaire d'inscription. Mise à jour partielle : n'envoyer que les champs à modifier, et pour chacun que les propriétés à changer. Il n'est pas nécessaire de renvoyer la configuration complète — les champs absents du tableau, comme les propriétés absentes d'une entrée, restent inchangés. Les Quatre comportements à connaître :
|
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 |
Field '{id}' is not attached to this discussion | Un des | |
FORBIDDEN | You don't have the permission for this request | L'utilisateur de la clé n'a pas le droit d'écriture sur le média ou le direct qui porte la discussion. Modérer les messages ne suffit pas pour changer les réglages. |
INPUT_VALIDATION_ERROR | Validation failed: fields: Each field id may appear only once in fields | Un même |
Validation failed: fields: A mandatory field must be active | Le formulaire résultant aurait un champ inactif marqué obligatoire. La règle porte sur l'état après fusion avec les champs non fournis ; rien n'est modifié, ni les champs ni les autres réglages de la discussion. | |
Validation failed: fields: The display key field must be active | Le formulaire résultant aurait un champ inactif porteur de la clé d'affichage. Rien n'est modifié. | |
Validation failed: fields: Exactly one active field must be the display key | Le formulaire résultant a au moins un champ actif, mais aucun ou plusieurs champs porteurs de la clé d'affichage : dès qu'un champ est actif, exactement un champ porte la clé (c'est lui qui nomme l'auteur). Un formulaire sans champ actif n'en porte aucune. Rien n'est modifié. |
60 requêtes par minute par clé API
En cas de dépassement, une erreur 429 Too Many Requests est retournée.