Games
Game Engine
Engage

Buy generator units with buzz

Changed on

quantity is an integer 1-100, else 400 IDLE_MAX_PER_CALL. Unknown generatorId returns 400 VALIDATION_ERROR. Locked generators (unlock thresholds unmet) return 409 IDLE_GENERATOR_LOCKED. Insufficient buzz returns 409 IDLE_INSUFFICIENT_BUZZ with no partial write. Crossing 25/50 owned per generator appends milestones and grants +1 Playbook each (max 8 per run). Idempotent per idempotencyKey. Optional X-Client-Version below minClientVersion returns 403 GAME_UPDATE_REQUIRED.

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

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

generatorId'rookie-card' | 'foam-finger-stand' | 'zamboni-fleet' | 'banner-press' required
quantityinteger required
idempotencyKeystring uuid required

Response

{ ledger, costPaid, playbooksGranted }

costPaidstring required

BigInt serialized as decimal string.

playbooksGrantedinteger required

0 when no milestone threshold was crossed.

Changes