Crediti

Leggere il saldo

GET /api/v1/credits richiede credits:read e restituisce soltanto il saldo disponibile come numero intero.

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

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

Ciclo di vita della riserva

I crediti vengono riservati in modo atomico non appena un job viene accettato per la prima volta. Questo impedisce che due richieste concorrenti spendano lo stesso saldo. Una richiesta idempotente ripetuta riutilizza la riserva originale.

• I job riusciti liquidano esattamente una volta l'importo riservato.
• I fallimenti terminali rilasciano esattamente le allocazioni originali.
• Il lavoro ritentato internamente non crea una nuova riserva.
• credits_reserved e credits_consumed sono visibili su ogni job.

Se alla creazione del job il saldo disponibile è insufficiente, l'API restituisce HTTP 402 con INSUFFICIENT_CREDITS; non viene creato né job né riserva.