Quavsit se compte en unités, sur le mois civil en UTC.
Appel | Unités |
Tout endpoint de lecture | 1 |
| 5 |
Chaque événement | 1 |
| 0 |
Les unités ne sont débitées qu’après une réponse réussie. Une requête qui échoue ne coûte rien.
Lire votre propre compteur
Trois en-têtes accompagnent chaque réponse :
En-tête | Valeur |
| Unités débitées par cet appel |
| Unités restantes ce mois-ci, ou |
| Moment de la remise à zéro du compteur mensuel |
GET /usage donne le tableau complet, et la page de compte affiche la période en cours, les sept derniers jours et l’usage par clé.
Dépenser moins
Utilisez les requêtes conditionnelles. Les ressources statiques — réseaux, lignes, arrêts, tracés — portent un
ETag. EnvoyezIf-None-Match: un304 Not Modifiedne coûte aucune unité.Respectez les en-têtes de cache. Chaque réponse porte un
Cache-Controlavec le TTL de sa source la plus fraîche : 10 à 20 secondes en temps réel, 300 secondes pour les données statiques. Interroger plus vite n’achète que des unités.Demandez un pôle plutôt que chaque quai. Un pôle agrège en un appel les départs de tous ses arrêts.
Un itinéraire coûte cinq unités. Mettez en cache un résultat que vous allez afficher deux fois.
Les mêmes unités paient tout
Les clés d’API, les tableaux de départs et les encarts consomment les mêmes unités mensuelles, sur la même offre, sous le même réglage de dépassement et le même plafond de dépense. Un tableau qui se rafraîchit toutes les 30 secondes prend son budget sur le même compteur que vos appels d’API.
La limite par minute est un autre sujet
Les requêtes sont aussi comptées par minute et par compte. Dépasser le chiffre de l’offre est refusé avec un en-tête Retry-After, et rien n’est débité. La fenêtre est glissante : étalez le trafic plutôt que de tout envoyer en début de minute.
Si les chiffres ne tombent pas juste
Comparez X-Quavsit-Units sur vos propres appels avec l’usage par clé de la page de compte. Un écart entre les deux, c’est un tableau ou un encart qui puise dans le même budget.
Référence d’aide Quavern : quavsit-units/fr
