REST API
All API calls return a string Result value as the first field in the returned data. Possible values are:
Result | Description |
SUCCESS | |
CALL_ALREADY_IN_PROCESS | |
WAITING_FOR_GAME | |
GAME_ALREADY_STARTED | |
GAME_HAS_ENDED | |
INVALID_LOGIN_OR_PASSWORD | |
INVALID_PLAYER_KEY | |
BOT_IS_SUSPENDED | |
BOT_IS_INACTIVE | |
INSUFFICIENT_BALANCE | |
NOT_YOUR_MOVE | |
INVALID_MOVE | |
Value | Description |
STARTING_SOON | Game will start shortly |
RUNNING | Game is in progress |
WON | Game is over and this client won |
WON_BY_TIMEOUT | This client won by the other player timing out |
LOST | This client lost |
LOST_BY_TIMEOUT | This client lost by timing out |
DRAWN | The game ended in a draw |
All API access is over HTTPS, and accessed through:
post
/prod/GM-GetListOfGameStyles
Get List Of Game Styles
post
/prod/GM-OfferGame
Offer Game
post
/prod/GM-CancelGameOffer
Cancel Game Offer
post
/prod/GM-PollForGameState
Poll For Game State
post
/prod/GM-MakeMove
Make Move
You can try out the API using the handy Postman app for Chrome - use this link:
We have created a complete GUI app in Python that uses the REST API to play games on our site. This provides a great example of how each REST API call should be implemented.
You can find out more details about this and how to download it on our Test harness using the REST API
page.