https://gateway.streamfizz.live/apiMessages racines d'une discussion, réponses imbriquées. Les messages de
modérateur réservés à l'animateur ne sortent qu'avec le filtre
presenterOnly.
| Nom | Type | Description |
|---|---|---|
discussionId* | ID! | Discussion dont lire les messages. |
limit | Int= 20 | Nombre de messages par page, 100 au plus. |
cursor | String | Curseur rendu par |
filter | MessageFilter | Filtre appliqué, un seul à la fois. Sans filtre, tous les messages racines sortent, hors messages réservés à l'animateur. |
messageGroupId | ID | Groupe à afficher. Se combine avec |
search | String | Texte recherché dans les messages et leurs réponses, sans distinction de casse. |
sortBy | MessageSortField= createdAt | Critère de tri. |
MessageConnection| Nom | Type | Description |
|---|---|---|
totalCount | Int! | Nombre total d'éléments, toutes pages confondues. |
counters | MessageCounters! | Nombre de messages par filtre, pour l'ensemble de la discussion. Ces nombres ne suivent NI le filtre, NI la recherche de la requête : ils servent à afficher le volume de chaque filtre à côté du sélecteur. Ils ne sont calculés que s'ils sont demandés, donc inutile de les redemander à chaque page. |
pageInfo | PaginationInfo! | Pagination : y a-t-il une suite, et depuis quel curseur. |
messages | [Message!]! | Les éléments de la page courante. |
| 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 |
Group '{id}' is not attached to this discussion | Le groupe n'existe pas, ou il appartient à une autre discussion que celle désignée par | |
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. |
BAD_USER_INPUT | Invalid cursor | Le |
60 requêtes par minute par clé API
En cas de dépassement, une erreur 429 Too Many Requests est retournée.