API

A small, strict, documented API.

Versioned under /api/v1. The authoritative contract is the OpenAPI specification; a test fails if a route and the spec ever drift apart.

Open openapi.yaml

Quick start (sandbox)

bash

# 1. list games
curl -H "Authorization: Bearer $KEY" https://nextgensoftware.org/api/v1/games

# 2. launch (simulated)
curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"player_id":"u1","currency":"XTS"}' https://nextgensoftware.org/api/v1/games/GAME_ID/launch

# 3. bet (amount in minor units; transaction_id is the idempotency key)
curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"player_id":"u1","currency":"XTS","transaction_id":"bet-1","amount":1000,"game_id":"GAME_ID","round_id":"r1"}' https://nextgensoftware.org/api/v1/wallet/bet

Money

Integers in minor units. No decimals, no strings, no floats.

Idempotency

transaction_id is unique per operator; replays return the original result.

Errors

A stable envelope with machine-readable codes and a correlation id.

Operator API keys are issued in the operator portal after onboarding.