shmishtopher / T3AAS

:beers: Tic-Tac-Toe (As A Service)

T3AAS

Tic-Tac-Toe (As A Service)

The easiest, most advanced, Tic-Tac-Toe API on the web. With T3AAS, you can do such impressive things as:

• Play Tic-Tac-Toe through a REST API
• Loose Tic-Tac-Toe through a REST API
• Integrate Tic-Tac-Toe into your app (through a REST API)

Why

I was challenged to build the most useless API on the web, check out some other entries here

How

Run your own instance of T3AAS by running node src/index.js in a cloned repository (defaults to port 3000) or use the public endpoint at https://t3aas--christopherschmitt.repl.co/ (hosted by repl.it).

Usage

All responses are JSON objects and take the form of:

{
  ok: true,
  msg: 'In Progress',
  token: '072949F3E6A72B5426DDF8B26162FAC8BC13CF12C6E33D85CEB9C0581E1A1F9A',
  game: 'in-progress',
  state: [0, 1, 2, 3, 'X', 5, 6, 7, 8]
}

All interaction with the API is done through URL query parameters that take the form of:

https://t3aas--christopherschmitt.repl.co/?cmd=<COMMAND>&tok=<TOKEN>

For example, a move to space 0 might look like this:

https://t3aas--christopherschmitt.repl.co/?cmd=0&tok=072949F3E6A72B5426DDF8B2

If you wish to begin a new session, omit the tok=<TOKEN> parameter and set your command parameter to cmd=NEW:

https://t3aas--christopherschmitt.repl.co/?cmd=NEW

This will return a JSON response with a unique token with you will need to provide to every subsequent command. Tokens will expire after 60 seconds if not used. (Performing a move will refresh this timer)

Quickstart

// A demo using JS and fetch

async function main () {
  const token = await fetch('https://t3aas--christopherschmitt.repl.co/?cmd=NEW')
    .then(res => res.json())
    .then(res => res.token)
    .catch(console.log)
  
  console.log(token)
}

main()

# Tic-Tac-Toe with Python
import requests

init = requests.get('https://t3aas--christopherschmitt.repl.co/?cmd=NEW').json()

if (init['ok']):
  print(init['state'][0:3])
  print(init['state'][3:6])
  print(init['state'][6:9])

  while 1:
    move = input('Enter yout move:')
    board = requests.get('https://t3aas--christopherschmitt.repl.co/?cmd=%s&tok=%s' % (move, init['token'])).json()
    
    print(board['msg'])
    print(board['state'][0:3])
    print(board['state'][3:6])
    print(board['state'][6:9])