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/v3/tic-tac-toe/fetch

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é
privatestringoptionnel
Définir à true pour créer une partie privée (défaut : false)

Exemple de requête

Requête

curl -X POST -d "username=Utilisateur1&game=VWXYZ" "https://api.moxon.dev/v3/tic-tac-toe/fetch"

Réponse

{
    "id": "VWXYZ",
    "moves": [
        {
            "username": "Utilisateur1",
            "move": "2-2",
            "session": "abc123"
        },
        {
            "username": "Utilisateur2",
            "move": "1-3",
            "session": "def456"
        }
    ],
    "players": ["Utilisateur1", "Utilisateur2"],
    "turn": "Utilisateur1",
    "status": "ready",
    "private": false
}

Champs de réponse

Champ	Description
`id`	Identifiant de la partie
`moves`	Tableau des coups joués
`players`	Tableau des noms d'utilisateur des joueurs
`turn`	Nom d'utilisateur du joueur dont c'est le tour
`status`	Statut de la partie (`waiting`, `ready`, `finished`)
`private`	Si la partie est privée

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

Réponse de partie terminée

{
  "id": "VWXYZ",
  "moves": [...],
  "players": ["Utilisateur1", "Utilisateur2"],
  "turn": null,
  "status": "finished",
  "private": false,
  "winner": "Utilisateur1",
  "loser": "Utilisateur2",
  "tie": false
}

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.

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

Modifier cette page sur GitHub Signaler un problème

Mis à jour le 8 avril 2026