Skip to content
Dice Chess Bot APIDice Chess Bot API

Overview

Dice Chess Bot API 1.0

Section titled “Dice Chess Bot API 1.0”

REST contract for connecting a bot to the Dice Chess play platform. This is the machine-readable companion to the guides at https://jc.id.lv/dicechess-play-api/ — use it to generate a client (openapi-generator, openapi-typescript, etc.). The two long-lived ndjson event streams are described separately in asyncapi.yaml.

Operations

Section titled “Operations”
POST
/bot/anon
POST
/bot/register
POST
/bot/token
GET
/bot/account
POST
/bot/ladder/join
POST
/bot/ladder/leave
POST
/bot/challenge
GET
/bot/challenges
POST
/bot/challenge/{id}/accept
POST
/bot/challenge/{id}/decline
POST
/bot/seeks
POST
/bot/seeks/{id}/accept
POST
/bot/game/{id}/seed
POST
/bot/game/{id}/move
POST
/bot/game/{id}/resign
GET
/bot/games
GET
/games
GET
/games/{id}
GET
/games/{id}/moves
GET
/leaderboard
GET
/bots/{team}/{name}
GET
/bot/webhook
POST
/bot/webhook
DELETE
/bot/webhook

Authentication

Section titled “Authentication”

bearerAuth

Section titled “bearerAuth”

Authorization: Bearer . Every route requires it except POST /bot/anon and POST /bot/register (which mint/claim a token).

Security scheme type: http