Difference between revisions of "W3911 Sudoku Server"
From Coder Merlin
(Added difficulty) |
|||
Line 9: | Line 9: | ||
End Points | End Points | ||
* POST /games | * POST /games?difficulty=<difficulty> | ||
* Action: Creates a new game and associated board | * Action: Creates a new game and associated board | ||
* Parameters: | |||
* difficulty: easy|medium|hard|hell | |||
* Payload: None | * Payload: None | ||
* Response: Id uniquely identifying a game | * Response: Id uniquely identifying a game |
Revision as of 10:06, 6 October 2021
Within these castle walls be forged Mavens of Computer Science ...
— Merlin, The Coder
Background A Sudoku board is made up of nine boxes. Boxes (container for nine cells) are listed from top-to-bottom, left-to-right indexed from zero. Cells are listed from top-to-bottom, left-to-right, indexed from zero. All valid payloads and responses must use well-formed JSON. “cells” is returned as follows: “cells”: [[<nine values from top-left>], [<nine values from top-middle>], …]
End Points
- POST /games?difficulty=<difficulty>
* Action: Creates a new game and associated board * Parameters: * difficulty: easy|medium|hard|hell * Payload: None * Response: Id uniquely identifying a game * Status code: 201 Created
- GET /games/<id>/cells
* Action: None * Payload: None * Response: cells * Status code: 200 OK
- PUT /games/<id>/cells/<boxIndex>/<cellIndex>
* Action: Place specified value at in game at boxIndex, cellIndex * Payload: value (null for removing value) * Response: Nothing * Status: 204 No Content