Skip to content

Récupération du morpion

L'endpoint /tic-tac-toe/fetch permet d'afficher une partie de morpion en cours. Vous pouvez utiliser l'identifiant de la partie en cours pour l'afficher.

Paramètres

ParamètreRequisDescription
usernameOuiLe nom d'utilisateur effectuant la requête
gameNonL'identifiant de la partie à afficher. S'il n'est pas fourni, un nouvel identifiant de partie sera généré

Exemple de requête

bash
curl -X POST -d "username=Utilisateur1&game=VWXYZ" "https://api.sylvain.pro/v2/tic-tac-toe/fetch"

Réponse

json
{
  "id": "VWXYZ",
  "moves": [
        {
          "username": "Utilisateur1",
          "move": "2-2",
          "session": "abc123"
        },
        {
          "username": "Utilisateur2",
          "move": "1-3",
          "session": "def456"
        },
        {
          "username": "Utilisateur1",
          "move": "1-2",
          "session": "abc123"
        },
        {
          "username": "Utilisateur2",
          "move": "2-3",
          "session": "def456"
        }
    ],
  "players": ["utilisateur1", "utilisateur2"],
  "turn": "utilisateur1",
  "status": "ready",
  "winner": null,
  "loser": null,
  "tie": false
}

Gestion des erreurs

Si une valeur de username est vide, une erreur sera renvoyée. Lorsque la partie est créée, un identifiant de session est généré et renvoyé dans la réponse. Vous pouvez utiliser cet identifiant pour effectuer des mouvements dans la partie. Si la partie est terminée, le gagnant et le perdant sont renvoyés dans la réponse.