Crédits

Lire le solde

GET /api/v1/credits exige credits:read et ne renvoie que le solde disponible sous forme d'entier.

curl https://sci-draw.com/api/v1/credits \
  -H 'Authorization: Bearer sd_YOUR_KEY'

{ "success": true, "data": { "balance": 125 } }

Cycle de vie d'une réservation

Les crédits sont réservés de façon atomique dès qu'un job est accepté pour la première fois. Cela empêche deux requêtes concurrentes de dépenser le même solde. Une requête idempotente répétée réutilise la réservation d'origine.

• Un job réussi règle exactement une fois le montant réservé.
• Un échec définitif libère exactement les allocations d'origine.
• Le travail interne réessayé ne crée pas de nouvelle réservation.
• credits_reserved et credits_consumed sont visibles sur chaque job.

Si le solde disponible est insuffisant au moment de la création, l'API renvoie HTTP 402 avec INSUFFICIENT_CREDITS ; aucun job ni aucune réservation n'est créé.