Stationsdaten
Stationen nach ID oder Marktfilter.
Nutzen Sie Stationsabrufe für aktuelle Beobachtungen nach Station, Stadt, Postleitzahl, Land oder Gebiet.
Stations-IDStadt oder PostleitzahlLand und KraftstoffGebietsfilter
Fuel PriceHubAPI-Dokumentation
Stationsdaten und aggregierte Kraftstoffpreise mit klaren Billing-Regeln abrufen.
Die kommerzielle API ist für authentifizierte Kundenkonten ausgelegt. Käufer können aktuelle Stationsdaten, Stationshistorie oder Marktdurchschnitte nach Marke, Standort, Kraftstoff und Zeitraum abrufen.
AuthentifizierungJeder kommerzielle Abruf nutzt einen Kunden-API-Key, der Organisation und Abo zugeordnet ist.
QuotaErfolgreiche abrechenbare Datenantworten zählen zum monatlichen Request-Paket.
SchutzFehlende Abdeckung, ungültige Parameter und nicht verfügbare Historie sollen vor Billing stoppen.
Unterstützte Abrufmuster
Unterstützte Abrufmuster
Die API folgt typischen Kundenfragen. Detaillierte Felddefinitionen und Response-Verträge werden nach Qualifizierung privat geteilt.
Historie
Stationshistorie mit Verfügbarkeitsprüfung.
Fordern Sie ein Zeitfenster an. Die API soll Abdeckung bestätigen, bevor die Anfrage zählt.
Start- und EnddatumAktuelle TageshistorieLänderverfügbarkeitNicht verfügbare Historie zählt nicht
Aggregate
Durchschnittspreise nach Marke, Ort und Zeit.
Nutzen Sie Aggregate für tägliche oder wöchentliche Durchschnitte nach Marke, Stadt, Postleitzahl, Region, Land oder Kraftstoff.
MarkendurchschnittStadt- oder PLZ-DurchschnittWöchentlicher MarktdurchschnittLandestrend
Wie eine Anfrage funktioniert
Wie eine Anfrage funktioniert
Kommerzielle Anfragen nutzen HTTPS, API-Key, Landesscope und explizite Filter. Der genaue Vertrag steht nach Freigabe im Kundenportal.
1Stationsdaten oder Marktaggregate wählen.
2Land, Kraftstoff, Standort- oder Markenfilter und optionalen Zeitraum angeben.
3Verfügbarkeit vor einem abrechenbaren Abruf validieren.
4Nur erfolgreiche Datenantworten zählen zu Quota oder Overage.
Billing- und Quota-Sicherheit
Billing- und Quota-Sicherheit
Die Zielregel ist einfach: Kunden zahlen für erfolgreichen Datenzugriff, nicht für Fehler, fehlende Märkte oder nicht unterstützte Historie.
Zählt zur Quota
- Authentifizierte Anfrage liefert aktuelle Stationsdaten.
- Authentifizierte Anfrage liefert verfügbare Stationshistorie.
- Authentifizierte Anfrage liefert ein Aggregat für unterstützten Markt und Zeitraum.
Zählt nicht
- Fehlender oder ungültiger API-Key.
- Ungültige Parameter oder nicht unterstützte Filter.
- Land, Stadt, Station, Marke oder Historie nicht verfügbar.
- Validierte Anfrage hat keine unterstützten Daten.
- Serverfehler vor nutzbarer Datenantwort.
Was im API-Layer noch durchgesetzt werden muss
Was im API-Layer noch durchgesetzt werden muss
Konto, Preise und Checkout sind live. Nächster Backend-Schritt ist API-Key-Validierung, Usage-Zählung und Stripe-Overage-Reporting.
API-Keys mit OrganisationsrechtenMonatliche Zähler je Key und AboNicht abrechenbare Preflight-PrüfungenOverage-Reporting erst nach inkludierter Quota