Déclarer ce qui a été fourni pour un compte, sur une période
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
- covered_fromstring · daterequis
Réponse
Couverture enregistrée, ou fusionnée avec une voisine.
- 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 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
| Statut | Code | Titre |
|---|---|---|
401 | invalid_api_key | La credential présentée n'est pas utilisable. |
403 | account_inactive | Le workspace ou l'organisation n'est pas actif. |
413 | request_entity_too_large | Le corps de la requête dépasse la borne. |
415 | unsupported_media_type | Le corps doit être du application/json. |
429 | rate_limited | Trop de requêtes. La limite de débit de cette clef est atteinte. Rejouez après le délai de Retry-After. |
500 | internal_error | Une erreur interne est survenue. |