Tic-Tac-Toe Play

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

PATCH/v4/tic-tac-toe/:game

Parameters

Parameter	Required	Description
game	Yes	The game identifier (URL parameter)
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

The game parameter is part of the URL path. The other 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 PATCH \
  -H "Content-Type: application/json" \
  -d '{
    "username": "alice",
    "move": "1-1",
    "session": "abc123"
  }' \
  "https://api.sylvain.sh/v4/tic-tac-toe/VWXYZ"

Try It

PATCHhttps://api.sylvain.sh/v4/tic-tac-toe/VWXYZ

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 /v4/tic-tac-toe - Main game endpoint for making moves
• DELETE /v4/tic-tac-toe/:game - Forfeit a game
• POST /v4/tic-tac-toe/fetch - Retrieve current game information
• POST /v4/tic-tac-toe/list - List all public games