Passer au contenu principal

Les unités, et ce que coûte chaque appel

Quavsit se compte en unités : 1 par lecture, 5 par recherche d’itinéraire, 1 par événement de flux, et rien pour les erreurs, health, status ou un 304.

J
Écrit par Jean-Baptiste COULON--CHABAGNO

Quavsit se compte en unités, sur le mois civil en UTC.

Appel

Unités

Tout endpoint de lecture

1

GET /journeys

5

Chaque événement departures ou vehicles sur un stream

1

GET /health, GET /status, 304 Not Modified, erreurs

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

X-Quavsit-Units

Unités débitées par cet appel

X-Quavsit-Units-Remaining

Unités restantes ce mois-ci, ou unlimited

X-Quavsit-Period-End

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. Envoyez If-None-Match : un 304 Not Modified ne coûte aucune unité.

  • Respectez les en-têtes de cache. Chaque réponse porte un Cache-Control avec 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

Avez-vous trouvé la réponse à votre question ?