https://gateway.streamfizz.live/apiPublie un message dans une discussion. Par défaut au nom de l'utilisateur
authentifié et sous son pseudo de discussion ; avec author: viewer, le
message est enregistré comme s'il venait d'un spectateur du lecteur, ce qui
sert à préparer ou à animer une discussion. Le message est publié
immédiatement, sauf s'il est privé, réservé à l'animateur, ou si
isVisible: false.
| Nom | Type | Description |
|---|---|---|
discussionId* | ID! | Discussion dans laquelle écrire. |
value* | String! | Texte du message, 1 000 caractères au plus. |
author | MessageAuthor= moderator | Qui signe le message. Sans cet argument, c'est l'utilisateur authentifié
qui écrit, sous son pseudo de modération : c'est le cas courant.
Avec |
fields | [MessageFieldInput!] | Réponses au formulaire, pour un message de spectateur seulement. Le champ
désigné comme clé d'affichage donne le nom affiché. Chaque champ actif et
obligatoire doit être renseigné (valeur non vide), sinon l'appel est
refusé ( |
isVisible | Boolean= true | Publie ou non le message dès sa création. Par défaut, un message est publié ; le filtre anti-grossièretés ne s'applique jamais ici, puisque c'est un modérateur qui écrit. |
parentMessageId | ID | Message auquel répondre. La réponse doit viser un message racine. |
isPrivate | Boolean= false | Envoie la réponse par e-mail à l'auteur du message visé, sans la publier.
Nécessite L'envoi suppose que cet auteur ait renseigné son adresse dans le
formulaire de la discussion. Sans adresse, la réponse est créée quand
même — elle reste privée, donc lisible en modération seulement — mais
aucun e-mail ne part. Pour le savoir à l'avance, lire les |
presenterOnly | Boolean= false | Réserve le message à l'animateur : il n'est jamais publié dans le lecteur,
et il alimente la liste des notes du modérateur dans la vue animateur. Un
tel message est toujours créé avec |
isShownToPresenter | Boolean= false | Transmet le message à l'animateur, dans sa liste de questions. À la
différence de |
resolveParent | Boolean= false | Marque le message visé comme résolu dans la même opération. Nécessite
|
updatedAt | DateTime | Date affichée à la place de la date d'envoi, au format ISO 8601 décrit
sur |
likes | Int | Nombre de mentions « j'aime » affiché au départ. |
Message| Nom | Type | Description |
|---|---|---|
id | ID! | - |
value | String! | Texte du message, en texte brut : enregistré et renvoyé tel quel, HTML compris, jamais interprété. L'échapper à l'affichage. |
authorName | String! | Nom affiché à côté du message. Pour un spectateur, la valeur du champ du formulaire désigné comme clé d'affichage ; pour un modérateur, son pseudo sur la discussion, à défaut son pseudo par défaut, à défaut « Modérateur ». Chaîne vide pour un spectateur qui n'a pas renseigné ce champ, ou quand aucun champ du formulaire n'est actif. Texte brut, à échapper à l'affichage. |
fromModerator | Boolean! | Message écrit par un modérateur. |
isVisible | Boolean! | Message publié dans le lecteur. |
isCensored | Boolean! | Message marqué indésirable, donc retiré du lecteur. Posé par le filtre
anti-grossièretés quand la discussion a |
isPrivate | Boolean! | Réponse envoyée par e-mail à l'auteur du message, sans publication. |
isShownToPresenter | Boolean! | Message transmis à l'animateur. |
presenterOnly | Boolean! | Message d'un modérateur réservé à l'animateur, jamais publié dans le lecteur. |
isResolved | Boolean! | Message traité par la modération. |
likes | Int! | Nombre de mentions « j'aime ». |
parentMessageId | ID | Message auquel celui-ci répond. |
answersCount | Int! | Nombre de réponses au message. |
createdAt | DateTime! | Date d'envoi. |
updatedAt | DateTime | Date affichée à la place de |
resolvedAt | DateTime | Date à laquelle le message a été marqué résolu. |
resolvedBy | User | Utilisateur qui a marqué le message résolu. |
answers | [Message!]! | Réponses au message, de la plus récente à la plus ancienne. |
groups | [MessageGroup!]! | Groupes du message, dans leur ordre d'affichage. |
fieldValues | [MessageFieldValue!]! | Réponses du spectateur au formulaire 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 |
Message '{id}' has not been found | Le message n'existe pas, ou il appartient à une autre discussion que celle désignée par | |
Field '{id}' is not attached to this discussion | Un des | |
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. |
MESSAGE_NOT_ROOT | parentMessageId must reference a top-level message | Le |
INPUT_VALIDATION_ERROR | Validation failed: fields.{n}.value: Must be at most {max} characters | Une réponse au formulaire dépasse 30 caractères, ou 60 pour un champ e-mail. |
Validation failed: fields.{n}.value: Invalid email | La réponse à un champ e-mail n'est pas une adresse valide. Une chaîne vide reste acceptée pour un champ facultatif. | |
Validation failed: fields.{n}.value: Bidirectional control characters are not allowed | Une réponse contient un caractère de contrôle bidirectionnel (U+202A–U+202E, U+2066–U+2069, U+200E, U+200F, U+061C). | |
Validation failed: fields: Each field id may appear only once in fields | Un même | |
Validation failed: fields: Missing mandatory field '{label}' | Message de spectateur ( | |
Validation failed: value: {message} |
| |
Validation failed: fields: fields require a viewer message |
| |
Validation failed: parentMessageId: isPrivate and resolveParent require parentMessageId |
| |
Validation failed: author: isPrivate, presenterOnly and resolveParent require a moderator message |
| |
Validation failed: likes: likes must be greater than or equal to 0 |
| |
Validation failed: updatedAt: Invalid date: expected ISO 8601, e.g. 2026-09-02T14:30:00Z |
|
60 requêtes par minute par clé API
En cas de dépassement, une erreur 429 Too Many Requests est retournée.