Online Tic-Tac-Toe

• usernamestringrequired

  The username making the move

• movestringrequired

  The move played in row-column format (e.g., 1-1, 2-2, 3-3)

• sessionstringrequired

  The user's session identifier

• gamestringrequired

  The game identifier for connection. If the game does not exist, it will be created

The board is a 3x3 grid with positions numbered as follows:

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

• messagestring

  Status message about the move

• winnerstring|null

  Username of the winner (if game is over)

• loserstring|null

  Username of the loser (if game is over)

• tieboolean

  Whether the game ended in a tie

• 429Global rate limit exceeded.Global API rate limit reached
• 429You have exceeded the limit of X requests per hour.Hourly IP/token limit reached
• 400Rate limit exceeded. Try again in X seconds.Per-user short-window limit
• 400Invalid move. Please provide a valid move (e.g., 1-1, 2-2, 3-3).Invalid move format
• 400Game is full, you can only watch.Game already has two players
• 400Please wait for the other player to make a move.Not your turn
• 400Move already made. Please choose a different move.Cell already occupied
• 400Session ID mismatchSession doesn't match the player

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

• 400Please provide a username (?username={username})The username parameter is missing
• 400Please provide a valid move (&move={move})The move parameter is missing or invalid
• 400Please provide a valid session ID (&session={ID})The session parameter is missing or invalid
• 400Please provide a valid game ID (&game={ID})The game parameter is missing or invalid

When a game is over, the request will return the winner and loser names, as well as whether there is a tie.

• post/v5/tic-tac-toe/fetch - Retrieve current game information
• post/v5/tic-tac-toe/list - List all public games
• patch/v5/tic-tac-toe/:game - Play a move
• delete/v5/tic-tac-toe/:game - Forfeit a game