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.

posthttps://api.moxon.dev/v4/tic-tac-toe/fetch

Essayerpost/v4/tic-tac-toe/fetch

curl -X POST \  "https://api.moxon.dev/v4/tic-tac-toe/fetch" \  -H "Content-Type: application/json" \  -d '{}'

Envoyez la requête pour voir la réponse ici.

Paramètres

usernamestringrequis
Le nom d'utilisateur effectuant la requête
gamestringoptionnel
L'identifiant de la partie à afficher. S'il n'est pas fourni, un nouvel identifiant de partie sera généré
privatebooleanoptionnel
Définir à true pour créer une partie privée (défaut : false)

Exemples de code

curl -X POST \  "https://api.moxon.dev/v4/tic-tac-toe/fetch" \  -H "Content-Type: application/json" \  -d '{    "username": "Utilisateur1",    "game": "VWXYZ"  }'

Champs de réponse

idstring
Identifiant de la partie
movesobject[]
Tableau des coups joués
playersstring[]
Tableau des noms d'utilisateur des joueurs
turnstring|null
Nom d'utilisateur du joueur dont c'est le tour
statusstring
Statut de la partie (waiting, ready)
privateboolean
Si la partie est privée
winnerstring|null
Nom d'utilisateur du gagnant (partie terminée)
loserstring|null
Nom d'utilisateur du perdant (partie terminée)
tieboolean
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

Gestion des erreurs

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

400Please 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.

post/v4/tic-tac-toe - Endpoint principal du jeu pour effectuer des coups
post/v4/tic-tac-toe/list - Lister toutes les parties publiques

Modifier cette page sur GitHub Signaler un problème

Mis à jour le 21 avril 2026