API

Une API petite, stricte, documentée .

Versionnée sous /api/v1. Le contrat qui fait foi est la spécification OpenAPI ; un test échoue si une route et la spécification divergent.

Ouvrir openapi.yaml

Démarrage rapide (bac à sable)

bash

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

# 2. lancer (simulé)
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. miser (montant en unités mineures ; transaction_id est la clé d’idempotence)
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

Argent

Des entiers en unités mineures. Pas de décimales, pas de chaînes, pas de flottants.

Idempotence

transaction_id est unique par opérateur ; un rejeu renvoie le résultat d’origine.

Erreurs

Une enveloppe stable avec des codes lisibles par machine et un identifiant de corrélation.

Les clés API des opérateurs sont délivrées dans le portail opérateur après l’intégration.