Documentation API

Récupérez données station et agrégats avec règles de facturation claires.

L'API commerciale est conçue pour des requêtes authentifiées par compte client. Les acheteurs peuvent interroger les stations courantes, l'historique station ou les moyennes par enseigne, lieu, carburant et période.

Voir les tarifs Contacter ventes

AuthentificationChaque pull commercial utilise une clé API client liée à une organisation et un abonnement.

QuotaLes réponses data réussies et facturables comptent dans le forfait mensuel inclus.

ProtectionCouverture absente, paramètres invalides et historique indisponible doivent échouer avant facturation.

Types de pulls supportés

L'API est organisée autour des questions habituelles des clients. Les définitions de champs et contrats de réponse détaillés restent privés après qualification.

Ligne station

Données station par station ou marché filtré.

Utilisez les pulls station pour des observations courantes par station connue, ville, code postal, pays ou zone.

Identifiant stationVille ou code postalPays et carburantZone géographique

Historique

Historique station avec vérification de disponibilité.

Demandez une période d'historique station. L'API doit confirmer la couverture avant de compter la requête.

Dates début et finHistorique quotidien récentDisponibilité paysHistorique absent non facturé

Agrégats

Prix moyens par enseigne, lieu et période.

Utilisez les agrégats pour moyennes quotidiennes ou hebdomadaires par enseigne, ville, code postal, région, pays ou carburant.

Moyenne enseigneMoyenne ville ou code postalMoyenne marché hebdomadaireTendance pays

Comment faire une requête

Les requêtes commerciales utilisent HTTPS, une clé API, un pays cadré et des filtres explicites. Le contrat exact est fourni dans le portail client après approbation.

1Choisir données station ou agrégats marché.

2Fournir pays, carburant, filtres lieu ou enseigne, et période optionnelle.

3Utiliser une prévalidation pour confirmer la couverture avant un pull facturable.

4Seules les réponses data réussies comptent dans le quota ou le dépassement.

Sécurité quota et facturation

La règle cible est simple: le client paie l'accès data réussi, pas les erreurs, marchés absents ou fenêtres historiques non supportées.

Compte dans le quota

Requête authentifiée avec données station courantes.
Requête authentifiée avec historique station disponible.
Requête authentifiée avec agrégat pour marché et période supportés.

Ne compte pas

Clé API absente ou invalide.
Paramètres invalides ou filtres non supportés.
Pays, ville, station, enseigne ou historique indisponible.
Requête validée sans donnée supportée pour le périmètre demandé.
Erreur serveur avant livraison d'une réponse data utilisable.

Ce qui reste à appliquer côté API

Compte client, tarifs et checkout sont en ligne. La prochaine étape backend est de placer l'API commerciale derrière validation de clé, comptage d'usage et reporting Stripe.

Clés API liées aux droits organisationCompteurs mensuels par clé et abonnementPrévalidations non facturablesReporting dépassement après quota inclus

Voir les tarifs