Tic-Tac-Toe Jouer
L'endpoint /tic-tac-toe/play permet de jouer un coup dans une partie existante via une méthode REST.
Changement en 6.0.0
Cet endpoint passe de PATCH à POST, et son identifiant sort de l'URL : game est désormais envoyé dans le corps JSON. Les méthodes PATCH et DELETE n'existent plus nulle part dans l'API.
Paramètres
| Paramètre | Requis | Description |
|---|---|---|
game | Oui | L'identifiant de la partie |
username | Oui | Le nom d'utilisateur effectuant le coup |
move | Oui | Le coup joué (ex. : 1-1, 2-2, 3-3) |
session | Oui | L'identifiant de session de l'utilisateur |
À savoir
Tous les paramètres sont envoyés dans un body JSON avec Content-Type: application/json.
Champs de réponse
| Champ | Type | Description |
|---|---|---|
message | string | Message de statut du coup |
winner | string|null | Nom d'utilisateur du gagnant (si la partie est terminée) |
loser | string|null | Nom d'utilisateur du perdant (si la partie est terminée) |
tie | boolean | Si la partie s'est terminée par une égalité |
Exemples de code
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"game": "VWXYZ",
"username": "alice",
"move": "1-1",
"session": "abc123"
}' \
"https://api.sylvain.sh/v6/tic-tac-toe/play"Essayer
Gestion des erreurs
Si les paramètres sont manquants ou invalides, l'API retournera une erreur :
| Message d'erreur | Description |
|---|---|
Invalid move. Please provide a valid move (e.g., 1-1, 2-2, 3-3). | Format de coup invalide |
Game is full, you can only watch. | La partie a déjà deux joueurs |
Please wait for the other player to make a move. | Ce n'est pas votre tour |
Move already made. Please choose a different move. | Case déjà occupée |
Session ID mismatch | La session ne correspond pas au joueur |
Endpoints associés
- POST /v6/tic-tac-toe - Endpoint principal du jeu pour effectuer des coups
- POST /v6/tic-tac-toe/forfeit - Abandonner une partie
- POST /v6/tic-tac-toe/fetch - Récupérer les informations de la partie
- POST /v6/tic-tac-toe/list - Lister toutes les parties publiques