Webhooks — checkers

Checkers-specific webhook events, in addition to the standard events.

Events

Event	When it fires
`checkers.king`	A piece reaches the back rank and becomes a king
`checkers.capture`	One or more pieces are captured in a single move (including multi-jump chains)
`checkers.afk_warning`	Active player has been idle for 60 s — 30 s left before forfeit
`checkers.afk_timeout`	Active player did not move within 90 s and forfeited

`checkers.king`

Fired when a piece reaches the opponent's back rank and is promoted to king.

Field	Type	Description
`playerId`	string	Player whose piece was kinged
`square`	number	Board index (0–63) where the piece was kinged

{ "event": "checkers.king", "data": { "playerId": "user_123", "square": 4 } }

`checkers.capture`

Fired after any move that captures one or more pieces. Multi-jump chains fire a single event with all captured squares listed.

Field	Type	Description
`playerId`	string	Player who made the capture
`from`	number	Starting board index
`to`	number	Ending board index
`captures`	number[]	Board indices of all captured pieces

{ "event": "checkers.capture", "data": { "playerId": "user_123", "from": 21, "to": 14, "captures": [17] } }

`checkers.afk_warning`

Fired 60 seconds after the last move when the active player has not acted. The player has 30 seconds remaining before automatic forfeit. Only fires when afkTimeoutEnabled is true.

Field	Type	Description
`playerId`	string	Player ID who is AFK
`secondsRemaining`	number	Seconds until automatic forfeit (always 30)

{ "event": "checkers.afk_warning", "data": { "playerId": "user_123", "secondsRemaining": 30 } }

`checkers.afk_timeout`

Fired when the 90-second AFK limit is reached. The game ends immediately — a game.ended event follows with reason: "afk_timeout".

Field	Type	Description
`forfeitedPlayerId`	string	Player ID who was forfeited
`winnerId`	string	Player ID who wins by default

{ "event": "checkers.afk_timeout", "data": { "forfeitedPlayerId": "user_123", "winnerId": "user_456" } }

Beta Gamer GaaS API — questions? support@beta-gamer.com