API données S&R Pro
Prix des carburants, ruptures de stock, bornes de recharge et cours pétroliers en JSON, authentifiés par clé d'API. Données des sources publiques officielles, mises à jour en continu.
Démarrage
- Créez un compte et abonnez-vous (offres) ;
- Générez votre clé dans le dashboard ;
- Appelez l'API avec l'en-tête
x-api-key.
curl -H "x-api-key: sr_votre_cle" \
"https://stationsetrecharge.com/api/v1/partner/shortages"Endpoints
| Méthode | Chemin | Paramètres | Description |
|---|---|---|---|
GET | /api/v1/partner/prices | minLat, minLng, maxLat, maxLng | Prix courants des stations dans la bbox (fraîcheur ≤ 7 j), 5 000 max. |
GET | /api/v1/partner/prices/history | carburant, days | Historique national quotidien d’un carburant (7-365 jours, moyenne €/L). |
GET | /api/v1/partner/shortages | — | Ruptures de stock en cours par département et carburant. |
GET | /api/v1/partner/markets | — | Cours Brent et WTI des 90 derniers jours, en USD et EUR. |
GET | /api/v1/partner/irve | minLat, minLng, maxLat, maxLng | Bornes de recharge IRVE dans la bbox (puissance, accès). |
Quotas & erreurs
Starter : 10 000 appels/mois · Pro : 50 000 appels/mois, par clé (5 clés max). Chaque réponse
porte les en-têtes X-Quota-Limit et X-Quota-Used. Dépassement : HTTP 429.
Clé invalide : HTTP 401.
Attribution des sources
L'API agrège des données publiques dont la réutilisation implique la mention des sources : prix et ruptures data.economie.gouv.fr (Licence Ouverte 2.0), prix Belgique Statbel (CC BY 4.0), prix maxima Luxembourg STATEC/LUSTAT (CC0), prix Espagne MITECO, bornes IRVE transport.data.gouv.fr (Licence Ouverte), cours pétroliers EIA (domaine public) et taux de référence BCE. Vous revendez ou redistribuez ? Gardez ces mentions dans votre produit.