Utilisation et crédits
Ce qui est mesuré, ce qui coûte des crédits et ce que signifie un 402.
Chaque appel authentifié est mesuré par jour et par opération; GET /v1/usage renvoie la période demandée (from, to; au plus 92 jours; les 30 derniers par défaut) avec les totaux par opération et par jour. Les calculs sont de l'utilisation : mesurés, jamais facturés en crédits.
Les crédits paient les actions de production facturables avec des clés réelles et sont consommés une fois par demande (l'ID de la demande est la clé d'idempotence; une nouvelle tentative ne facture donc jamais deux fois). GET /v1/credits renvoie le solde et les mouvements récents. Une opération réelle qui exige plus de crédits que l'espace de travail n'en détient répond 402 CREDITS_REQUIRED avec required, balance et credits_url. Le bac à sable n'est jamais facturé. Les crédits s'ajoutent depuis la console des développeurs; les rails d'achat sont en cours de raccordement.
{ "error": "This operation needs 1 credit; the workspace holds 0.", "code": "CREDITS_REQUIRED", "requestId": "…", "required": 1, "balance": 0, "credits_url": "https://app.taxpio.com/app/developers/usage" }