Skip to content

Chat en ligne

L'endpoint /chat fournit un système de messagerie en temps réel avec support pour les canaux publics et privés. Les messages sont stockés pendant 1 heure.

Paramètres

ParamètreRequisDescription
usernameOuiLe nom d'utilisateur de l'expéditeur
messageOuiLe message à envoyer
sessionOuiL'identifiant de session de l'utilisateur
tokenNonLa clé utilisée pour se connecter à un chat privé. Si non fourni, le message sera envoyé dans le chat global

Exemples de code

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "username": "Utilisateur3",
    "message": "Comment ça va ?",
    "session": "abc123"
  }' \
  "https://api.sylvain.sh/v5/chat"

Champs de réponse

ChampTypeDescription
messagestringMessage de confirmation

Réponses d'erreur

ErreurDescription
Global rate limit exceeded.Limite globale de l'API atteinte
You have exceeded the limit of X requests per hour.Limite horaire IP/token atteinte
Rate limit exceeded. Try again in X seconds.Limite courte durée par utilisateur
Session ID mismatchLa session ne correspond pas à l'utilisateur

Essayer

Gestion des erreurs

Si les paramètres sont manquants ou invalides, l'API retournera une erreur :

Message d'erreurDescription
Please provide a username (?username={username})Le paramètre username est manquant
Please provide a message (&message={message})Le paramètre message est manquant
Please provide a valid session ID (&session={ID})Le paramètre session est manquant ou invalide

Endpoints associés