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.
POST/v5/chat
Paramètres
| Paramètre | Requis | Description |
|---|---|---|
username | Oui | Le nom d'utilisateur de l'expéditeur |
message | Oui | Le message à envoyer |
session | Oui | L'identifiant de session de l'utilisateur |
token | Non | La 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
| Champ | Type | Description |
|---|---|---|
message | string | Message de confirmation |
Réponses d'erreur
| Erreur | Description |
|---|---|
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 mismatch | La 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'erreur | Description |
|---|---|
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
- GET /v5/chat - Récupérer les messages récents
- POST /v5/chat/private - Créer et gérer des canaux de chat privés
- DELETE /v5/chat/:token - Effacer les messages d'un chat privé