Aller au contenu
Accueil moxon

Tic-Tac-Toe Jouer

L'endpoint /tic-tac-toe/play permet de jouer un coup dans une partie. Si l'identifiant game n'existe pas, la partie est créée.

posthttps://api.moxon.dev/v6/tic-tac-toe/play

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.

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

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

Paramètres

  • gamestringrequis

    L'identifiant de la partie. Si la partie n'existe pas, elle est créée

  • usernamestringrequis

    Le nom d'utilisateur effectuant le coup

  • movestringrequis

    Le coup joué au format ligne-colonne (ex. : 1-1, 2-2, 3-3), voir Format des coups

  • sessionstringrequis

    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

  • messagestring

    Message de statut du coup

  • winnerstring|null

    Nom d'utilisateur du gagnant (si la partie est terminée)

  • loserstring|null

    Nom d'utilisateur du perdant (si la partie est terminée)

  • tieboolean

    Si la partie s'est terminée par une égalité

Tant que la partie continue, la réponse ne contient que message (Move sent successfully). Les champs winner, loser et tie ne sont présents que lorsque le coup termine la partie.

Exemples de code

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
  • 400Please provide a valid move (&move={move})Le paramètre move est manquant
  • 400Please provide a valid session ID (&session={ID})Le paramètre session est manquant
  • 400Please provide a game ID (&game={ID})Le paramètre game est manquant
  • 400Rate limit exceeded. Try again in X seconds.Limite courte durée par utilisateur
  • 400Invalid move. Please provide a valid move (e.g., 1-1, 2-2, 3-3).Format de coup invalide
  • 400Game is full, you can only watch.La partie a déjà deux joueurs
  • 400Please wait for the other player to make a move.Ce n'est pas votre tour
  • 400Move already made. Please choose a different move.Case déjà occupée
  • 400Session ID mismatchLa session ne correspond pas au joueur

Endpoints associés

Modifier cette page sur GitHubSignaler un problème

Mis à jour le 17 octobre 2026