https://gateway.streamfizz.live/apiLit une discussion par son identifiant, qu'elle soit portée par un média ou
par un direct. Une discussion d'un autre compte est introuvable, de même que
celle d'un direct supprimé (statut Archived), sauf si elle est partagée
avec son replay.
| Nom | Type | Description |
|---|---|---|
discussionId* | ID! | Identifiant de la discussion, tel que rendu par le champ |
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: discussionId: Invalid CUID format | Le |
60 requêtes par minute par clé API
En cas de dépassement, une erreur 429 Too Many Requests est retournée.