Games
Game Engine
Engage

Submit batched buzz taps

Changed on

The client sends intent, never values. tapCount is an integer >= 1 with no wire max; values above 100 are clamped server-side (acceptedTaps=100, clampedTaps=tapCount-100). Non-integer or non-positive counts return 400 VALIDATION_ERROR. Sustained abuse returns 429 IDLE_TAP_RATE_LIMITED with a Retry-After header. Mutations carry a UUID v4 idempotencyKey: replaying the same key returns the stored response verbatim, while the same key with a mutated body returns 400 VALIDATION_ERROR with no second credit. Optional X-Client-Version below minClientVersion returns 403 GAME_UPDATE_REQUIRED.

post/api/v1/engage/games/locker-singularity/ledger/taps

Request

  • Base URL
    https://app.d-sports.org
  • Auth
    HTTP bearer

Headers

X-Client-Versionstring

Native client semver. Below minClientVersion returns 403 GAME_UPDATE_REQUIRED.

Request body

tapCountinteger required

No wire max; clamped to 100 per call server-side.

idempotencyKeystring uuid required

Response

{ ledger, acceptedTaps, clampedTaps, tapValue }

acceptedTapsinteger required
clampedTapsinteger required
tapValuestring required

BigInt serialized as decimal string.

Changes