Tic-Tac-Toe Play

The /tic-tac-toe/play endpoint plays a move in an existing game using a REST method.

POST/v6/tic-tac-toe/play

Changed in 6.0.0

This endpoint moved from PATCH to POST, and its identifier left the URL: game is now sent in the JSON body. PATCH and DELETE no longer exist anywhere in the API.

Parameters

Parameter	Required	Description
game	Yes	The game identifier
username	Yes	The username making the move
move	Yes	The move played (e.g., 1-1, 2-2, 3-3)
session	Yes	The user's session identifier

Good to know

All parameters are sent as a JSON body with Content-Type: application/json.

Response Fields

Field	Type	Description
message	string	Status message about the move
winner	string|null	Username of the winner (if game is over)
loser	string|null	Username of the loser (if game is over)
tie	boolean	Whether the game ended in a tie

Code Examples

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "game": "VWXYZ",
    "username": "alice",
    "move": "1-1",
    "session": "abc123"
  }' \
  "https://api.sylvain.sh/v6/tic-tac-toe/play"

Try It

POSThttps://api.sylvain.sh/v6/tic-tac-toe/play

game*

username*

move*

session*

Error Handling

If parameters are missing or invalid, the API will return an error:

Error Message	Description
Invalid move. Please provide a valid move (e.g., 1-1, 2-2, 3-3).	Invalid move format
Game is full, you can only watch.	Game already has two players
Please wait for the other player to make a move.	Not your turn
Move already made. Please choose a different move.	Cell already occupied
Session ID mismatch	Session doesn't match the player

Related Endpoints

• POST /v6/tic-tac-toe - Main game endpoint for making moves
• POST /v6/tic-tac-toe/forfeit - Forfeit a game
• POST /v6/tic-tac-toe/fetch - Retrieve current game information
• POST /v6/tic-tac-toe/list - List all public games