Récupération du morpion
L'endpoint /tic-tac-toe/fetch permet de récupérer les informations d'une partie de morpion en cours. Vous pouvez utiliser l'identifiant de la partie en cours pour l'afficher ou créer une nouvelle partie si aucun ID n'est fourni.
Paramètres
| Paramètre | Requis | Description |
|---|---|---|
username | Oui | Le nom d'utilisateur effectuant la requête |
game | Non | L'identifiant de la partie à afficher. S'il n'est pas fourni, un nouvel identifiant de partie sera généré |
private | Non | Définir à true pour créer une partie privée (défaut : false) |
Exemples de code
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"username": "Utilisateur1",
"game": "VWXYZ"
}' \
"https://api.sylvain.sh/v5/tic-tac-toe/fetch"Champs de réponse
| Champ | Type | Description |
|---|---|---|
id | string | Identifiant de la partie |
moves | object[] | Tableau des coups joués |
players | string[] | Tableau des noms d'utilisateur des joueurs |
turn | string|null | Nom d'utilisateur du joueur dont c'est le tour |
status | string | Statut de la partie (waiting, ready) |
private | boolean | Si la partie est privée |
winner | string|null | Nom d'utilisateur du gagnant (partie terminée) |
loser | string|null | Nom d'utilisateur du perdant (partie terminée) |
tie | boolean | Si la partie s'est terminée par une égalité |
Valeurs de statut de partie
| Statut | Description |
|---|---|
waiting | La partie a moins de 2 joueurs |
ready | La partie a 2 joueurs et est prête à être jouée |
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 |
Lorsqu'une nouvelle partie est créée, l'utilisateur est automatiquement ajouté à la liste des joueurs. Les parties privées ne sont pas visibles dans la liste publique des parties mais peuvent toujours être rejointes si vous connaissez l'ID de la partie.
Endpoints associés
- POST /v5/tic-tac-toe - Endpoint principal du jeu pour effectuer des coups
- POST /v5/tic-tac-toe/list - Lister toutes les parties publiques