Documentation technique

Comment interroger l'API : authentification, paramètres, exemples. Pour comprendre ce que représentent les données elles-mêmes, voir la documentation métier.

Base URL : https://api.pasdevelib.app

Authentification : en-tête X-API-Key, obtenu via une demande approuvée manuellement.

Paramètres communs : ?city=paris&kind=evolution

Villes disponibles : paris, bordeaux, lyon, toulouse, lille, rennes, strasbourg

Limite d'appels : 200 requêtes/jour par clé — au-delà, blocage strict jusqu'au lendemain.

Mise à jour : une fois par jour (calcul nocturne côté bot).

Endpoints disponibles

GET /v1/stats?city=paris&kind=period&period=day|week|month

Statistiques agrégées sur une période (jour/semaine/mois) : remplissage moyen, fiabilité, classements de stations, quartiers.

GET /v1/stats?city=paris&kind=evolution

Évolution quotidienne du taux de remplissage moyen sur les 90 derniers jours.

GET /v1/stats?city=paris&kind=patterns

Motif jour de semaine × heure (heatmap) du taux de remplissage moyen.

GET /v1/stats?city=paris&kind=records

Meilleur et pire jour observés (taux de remplissage moyen).

GET /v1/stats?city=paris&kind=traffic

Activité estimée (départs de vélos) par heure de la journée et par jour.

GET /v1/stats?city=paris&kind=stuck

Stations restées vides ou pleines le plus longtemps (séquences continues).

GET /v1/stats?city=paris&kind=weather

Comparaison de l'activité estimée entre jours de pluie et jours secs.

GET /v1/stats?city=paris&kind=typology

Classement des stations par profil de comportement (pendulaire / loisir-week-end / mixte).

GET /v1/stats?city=paris&kind=morning_signature

Par quartier, remplissage à midi moins remplissage du matin en semaine (exportateur/importateur).

Exemple

curl "https://api.pasdevelib.app/v1/stats?city=paris&kind=evolution" \
  -H "X-API-Key: VOTRE_CLE"

{
  "ready": true,
  "series": [
    { "date": "2026-04-27", "avg_fill_rate": 0.42 },
    { "date": "2026-04-28", "avg_fill_rate": 0.39 },
    ...
  ]
}

Codes de statut

200Succès — donnée renvoyée (ou {"ready": false} si pas encore calculée pour cette ville)

400Paramètre city ou kind invalide

401Clé API manquante, invalide, ou accès non actif

429Limite de 200 requêtes/jour atteinte

Ces données dérivées sont publiées sous Licence Ouverte / Open Licence 2.0 (Etalab), la même licence que les flux GBFS source. Réutilisation libre avec attribution et lien vers blog.pasdevelib.app/donnees. Réutilisation commerciale ou republication en masse soumise à autorisation préalable — contactez-nous.