QuavernQuavsit

Documentation

Référence de l’API Quavsit : authentification, réseaux, chaque point d’accès, flux, itinéraires, erreurs, limites et licences des données.

URL de base : https://api.quavern.net/v1

  1. 01Premiers pasQuavsit est une API HTTP en lecture seule pour les transports publics français : lignes, arrêts, prochains passages, position des véhicules, perturbations, lieux et itinéraires, pour plusieurs réseaux derrière un seul modèle de données. Cha
  2. 02AuthentificationChaque requête, sauf GET /health et GET /status, porte une clé personnelle dans l'en-tête Authorization.
  3. 03RéseauxQuavsit ouvre avec huit réseaux français. Chacun est exposé sous un slug court qui préfixe tous les identifiants du réseau. Ce qui est en temps réel, ce qui est théorique et ce qui manque dépend de ce que l'opérateur publie ; le tableau ci-
  4. 04ConceptsCette page définit les mots employés partout ailleurs : identifiants, arrêts et zones d'arrêt, fraîcheur, unités, enveloppe de réponse et gestion du temps.
  5. 05EndpointsURL de base https://api.quavern.net/v1. Toutes les routes sont en GET. Les exemples JSON sont illustratifs : identifiants, noms et heures sont plausibles, pas des données réelles. Chaque route coûte 1 unité sauf mention contraire.
  6. 06StreamsDeux endpoints poussent les mises à jour en server-sent events (SSE) au lieu d'être interrogés en boucle : les passages à un arrêt et les véhicules d'une ligne. Les streams demandent un plan avec le droit streams (tous les plans payants, Pa
  7. 07ItinérairesGET /journeys renvoie jusqu'à six itinéraires entre deux points. L'appel coûte 5 unités et les résultats sont mis en cache 60 secondes pour une requête identique.
  8. 08Lieux/places est le champ de recherche derrière l'application web : une requête, arrêts et adresses dans une seule liste. C'est aussi ainsi que /journeys résout le texte libre.
  9. 09ErreursChaque erreur est {"error": {"code", "reason", "message", "details"?}} avec le vrai statut HTTP. reason est le slug stable sur lequel brancher votre code ; code (de la forme QVST1-3404) est la référence à citer au support ; message est un t
  10. 10Limites et tarifsQuavsit se compte en unités. Les plans diffèrent par les unités comprises chaque mois, le nombre de requêtes autorisées par minute, le nombre de clés, l'accès aux streams et le prix des unités supplémentaires.
  11. 11Licences des donnéesQuavsit redistribue des données ouvertes publiées par les opérateurs et autorités organisatrices nommés ci-dessous. Leurs licences s'appliquent à ce que vous construisez avec l'API. Chaque réponse porte les mentions applicables dans meta.at
  12. 12Journal des changementsLes changements du contrat de l'API sont listés ici. Les ajouts sont rétrocompatibles ; les retraits sont annoncés au moins 90 jours à l'avance et apparaissent ici en premier.