{"info":{"_postman_id":"dffd84c1-2864-463a-a8a4-e688f7638773","name":"Tic-Tac-Toe API","description":"

Introduction

This API allows you to play Tic-Tac-Toe. You and someone can play together, or you can play against a computer, either against one that uses random algorithm, or a computer that is impossible to win against which uses the minimax algorithm.

I implemented this API on a react WebApp, try it out here or visit the github page.

Overview

There are 3 types of requests:

Create Session
POST - http://alkindi.pythonanywhere.com/session
\n
Get Session Details
GET - http://alkindi.pythonanywhere.com/session
\n
Play; make a move
POST - http://alkindi.pythonanywhere.com/session/play
\n

Status Codes

Status 200: Success.
Status 400: Something wrong with your request.
Status 500: Something wrong with the server.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Introduction","slug":"introduction"},{"content":"Overview","slug":"overview"},{"content":"Status Codes","slug":"status-codes"}],"owner":"25468658","collectionId":"dffd84c1-2864-463a-a8a4-e688f7638773","publishedId":"2s8ZDeSy5r","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2023-01-26T19:43:59.000Z"},"item":[{"name":"http://alkindi.pythonanywhere.com/session","id":"646c54e5-c8ef-47ba-abcb-4859653fe882","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"player_x\" : \"human\",\n \"player_o\" : \"random\",\n \"start\" : \"x\"\n}","options":{"raw":{"language":"json"}}},"url":"http://alkindi.pythonanywhere.com/session","description":"

Create a new tic-tac-toe game session

the request body parameter are:

player_x: accepts \"human\", \"random\", \"minimax\".
player_o: accepts \"human\", \"random\", \"minimax\".
start: accepts \"x\", \"o\".

the response body :

game_board: a list of the cells in the sessions's tic-tac-toe board; [0,1,2,3,4,5,6,7,8], empty items will contain the index of the item, and occupied items will contain either 'x' or 'o'.

Guide:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

0	1	2
3	4	5
6	7	8

id: the id of the session, you will need this for all future requests for this session
next_turn: 'x' or 'o'; this identifies the player that will play next.
player_o: 'human', 'robot' or 'minimax';this identifies the type of player that assigned to play with letter 'o'
player_x: 'human', 'robot' or 'minimax; this identifies the type of player that assigned to play with letter 'x'
result: blank string, 'x', 'o', or 'draw'; this identifies the result of the game.

\n","urlObject":{"protocol":"http","path":["session"],"host":["alkindi","pythonanywhere","com"],"query":[],"variable":[]}},"response":[{"id":"7e35acd2-2ff9-4119-87da-4a7685a63f10","name":"Default","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"player_x\" : \"human\",\n \"player_o\" : \"random\",\n \"start\" : \"x\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"http://alkindi.pythonanywhere.com/session","protocol":"http","host":["alkindi","pythonanywhere","com"],"path":["session"],"query":[{"key":"pla","value":null,"type":"text","disabled":true}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"game_board\": [\n 0,\n 1,\n 2,\n 3,\n 4,\n 5,\n 6,\n 7,\n 8\n ],\n \"id\": \"3788b48c-8cd7-4c02-802e-990ec64a9bc9\",\n \"next_turn\": \"x\",\n \"player_o\": \"random\",\n \"player_x\": \"human\",\n \"result\": \"\"\n}"}],"_postman_id":"646c54e5-c8ef-47ba-abcb-4859653fe882"},{"name":"http://alkindi.pythonanywhere.com/session","id":"d2e06c07-4cfa-43f5-a544-b881590af5a5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"id\": \"048b37bc-38e7-4377-a37e-3cdc39d6ad4f\"\n}","options":{"raw":{"language":"json"}}},"url":"http://alkindi.pythonanywhere.com/session","description":"

Get session details:
This allows you to get your tic-tac-toe session details.

the request body parameter are:

id: the id of the session that you want to get the details of.

the response body :

game_board: a list of the cells in the sessions's tic-tac-toe board; [0,1,2,3,4,5,6,7,8], empty items will contain the index of the item, and occupied items will contain either 'x' or 'o'.

Guide:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

0	1	2
3	4	5
6	7	8

id: the id of the session, you will need this for all future requests for this session
next_turn: 'x' or 'o'; this identifies the player that will play next.
player_o: 'human', 'robot' or 'minimax';this identifies the type of player that assigned to play with letter 'o'
player_x: 'human', 'robot' or 'minimax; this identifies the type of player that assigned to play with letter 'x'
result: blank string, 'x', 'o', or 'draw'; this identifies the result of the game.

\n","urlObject":{"protocol":"http","path":["session"],"host":["alkindi","pythonanywhere","com"],"query":[],"variable":[]}},"response":[{"id":"504b65d2-f831-4e0f-aea1-a49db0cac99c","name":"Default","originalRequest":{"method":"GET","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"id\": \"048b37bc-38e7-4377-a37e-3cdc39d6ad4f\"\n}","options":{"raw":{"language":"json"}}},"url":"http://alkindi.pythonanywhere.com/session"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"board\": [\n 0,\n 1,\n 2,\n 3,\n 4,\n 5,\n 6,\n 7,\n 8\n ],\n \"id\": \"048b37bc-38e7-4377-a37e-3cdc39d6ad4f\",\n \"next_turn\": \"x\",\n \"player_o\": \"random\",\n \"player_x\": \"human\",\n \"result\": \"\"\n}"}],"_postman_id":"d2e06c07-4cfa-43f5-a544-b881590af5a5"},{"name":"http://alkindi.pythonanywhere.com/session/play","id":"34dbbef4-ae95-459b-bf6b-7a3fdda092fc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":""},"url":"http://alkindi.pythonanywhere.com/session/play","description":"

Play:
This allows you to make a move.

the request body parameter are:

id: the id of the session that you want to get the details of.
cell: the cell in which you want to play.

the response body :

game_board: a list of the cells in the sessions's tic-tac-toe board; [0,1,2,3,4,5,6,7,8], empty items will contain the index of the item, and occupied items will contain either 'x' or 'o'.

Guide:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

0	1	2
3	4	5
6	7	8

id: the id of the session, you will need this for all future requests for this session
next_turn: 'x' or 'o'; this identifies the player that will play next.
player_o: 'human', 'robot' or 'minimax';this identifies the type of player that assigned to play with letter 'o'
player_x: 'human', 'robot' or 'minimax; this identifies the type of player that assigned to play with letter 'x'
result: blank string, 'x', 'o', or 'draw'; this identifies the result of the game.

\n","urlObject":{"protocol":"http","path":["session","play"],"host":["alkindi","pythonanywhere","com"],"query":[],"variable":[]}},"response":[{"id":"96010c60-a69e-4bdb-98ae-66a7f41fadb1","name":"Default","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"id\":\"048b37bc-38e7-4377-a37e-3cdc39d6ad4f\",\n \"cell\": 3\n}","options":{"raw":{"language":"json"}}},"url":"http://alkindi.pythonanywhere.com/session/play"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"board\": [\n 0,\n 1,\n \"o\",\n \"x\",\n 4,\n 5,\n 6,\n 7,\n 8\n ],\n \"id\": \"048b37bc-38e7-4377-a37e-3cdc39d6ad4f\",\n \"next_turn\": \"x\",\n \"player_o\": \"random\",\n \"player_x\": \"human\",\n \"result\": \"\"\n}"}],"_postman_id":"34dbbef4-ae95-459b-bf6b-7a3fdda092fc"}]}