Morpion en ligne

L'endpoint /tic-tac-toe permet de jouer et de stocker une partie de morpion en ligne. Les parties sont stockées pendant 1 heure et supportent les modes public et privé.

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

Essayerpost/v4/tic-tac-toe

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

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

Paramètres

usernamestringrequis
Le nom d'utilisateur effectuant le mouvement
movestringrequis
Le coup joué au format ligne-colonne (ex. : 1-1, 2-2, 3-3)
sessionstringrequis
L'identifiant de session de l'utilisateur
gamestringrequis
L'identifiant de la partie permettant la connexion. Si la partie n'existe pas, elle sera créée

Format des coups

Le plateau est une grille 3x3 avec des positions numérotées comme suit :

1-1 | 1-2 | 1-3
----|-----|----
2-1 | 2-2 | 2-3
----|-----|----
3-1 | 3-2 | 3-3

Exemples de code

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

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é

Réponses d'erreur

429Global rate limit exceeded.Limite globale de l'API atteinte
429You have exceeded the limit of X requests per hour.Limite horaire IP/token atteinte
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

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 ou invalide
400Please provide a valid session ID (&session={ID})Le paramètre session est manquant ou invalide
400Please provide a valid game ID (&game={ID})Le paramètre game est manquant ou invalide

Lorsqu'une partie est terminée, la requête retournera les noms du gagnant et du perdant, ainsi que s'il y a égalité.

post/v4/tic-tac-toe/fetch - Récupérer les informations de la partie en cours
post/v4/tic-tac-toe/list - Lister toutes les parties publiques
patch/v4/tic-tac-toe/:game - Jouer un coup
delete/v4/tic-tac-toe/:game - Abandonner une partie

Modifier cette page sur GitHub Signaler un problème

Mis à jour le 21 avril 2026