Aller au contenu
Sandbox

Déclarer ce qui a été fourni pour un compte, sur une période

Voir en Markdown

Une couverture est un fait de compte et de période, pas de transaction. Elle répond à « toutes les opérations de ce compte entre ces deux dates vous ont-elles été fournies ? » — et elle existe précisément quand il n'y a aucune transaction à envoyer : un mois sans prélèvement est le cas où la déclaration compte le plus. C'est pour cela qu'elle a sa propre ressource plutôt qu'un champ sur l'enrichissement. Sans elle, nous ne dirons jamais qu'une série est en retard : l'absence d'une échéance ne prouve rien tant que nous ignorons si le compte était observé, et lifecycle.state reste unknown. Et nous ne vérifions rien : ce que vous déclarez est enregistré comme une affirmation d'appelant (caller_asserted). La provenance n'est pas un champ que vous choisissez. L'appel est idempotent par construction : les intervalles qui se touchent fusionnent, donc une synchronisation horaire ne fabrique pas d'intervalles.

Requête

application/jsonCoverageWindow
  • covered_fromstring · daterequis

Réponse

Couverture enregistrée, ou fusionnée avec une voisine.

application/jsonCoverageWindowResult
  • covered_fromstring · daterequis
  • covered_tostring · daterequis
  • merged_intervalsinteger ≥ 0requis
  • policy_versionstringrequis
  • notestring
  • request_idstringrequis

Limite de débit

debit_ti_v1operational_burst_protection · token_bucket
120 / min
par clé · capacité 120 · recharge 2/s
600 / min
par workspace · capacité 600 · recharge 10/s

« 120 requetes / minute » est traduit en seau a jetons : capacite 120 (la rafale toleree) rechargee a 2 jetons / seconde (le regime durable). Une clef au repos peut envoyer 120 requetes d'un coup, puis 2 par seconde ; sur la premiere minute apres un repos, jusqu'a 240 passent. Le workspace, lui, borne la somme de toutes ses clefs a 600 / minute (capacite 600, 10 / s) : cent clefs ne font pas cent fois la limite.

Ce n'est pas : sandbox_lifetime_quota · production_usage_quota · billing_entitlement · commercial_promise

Erreurs possibles

Code
StatutCodeTitre
401invalid_api_keyLa credential présentée n'est pas utilisable.
403account_inactiveLe workspace ou l'organisation n'est pas actif.
413request_entity_too_largeLe corps de la requête dépasse la borne.
415unsupported_media_typeLe corps doit être du application/json.
429rate_limitedTrop de requêtes.
La limite de débit de cette clef est atteinte. Rejouez après le délai de Retry-After.
500internal_errorUne erreur interne est survenue.

Toutes les erreurs

Cette page vous a-t-elle aidé ?