Plein-moins-cher API
plein-moins-cher bietet eine kostenpflichtige API, mit der Sie von Tankstellen in Frankreich berechnete Kraftstoffpreise in Echtzeit abrufen können.
Daten zum Datenfluss
Die Quelle des Stroms stammt von der Regierungsseite prix-carburants.gouv.fr, die nahezu in Echtzeit Daten zu den von Tankstellen in Frankreich berechneten Kraftstoffpreisen bereitstellt.
Der Feed wurde von plein-moins-cher angepasst, um den Datensatz mit den Namen und Marken von Tankstellen anzureichern (Daten sind im offiziellen Feed nicht direkt verfügbar).
Der Durchfluss wird ungefähr alle 10 Minuten neu berechnet, um den Preisschwankungen, die an Tankstellen ein- oder mehrmals täglich praktiziert werden, möglichst nahe zu kommen.
Haftungsbeschränkungen
Die Preisinformationen und das Datum/die Uhrzeit der Aktualisierung je Kraftstoff sowie die Postanschriften der Verkaufsstellen werden nicht umgewandelt: Sie werden wie auf der Website der Regierung angegeben zurückgegeben.
Die Namen und Marken der Tankstellen stammen ebenfalls von der Regierungsseite, stammen jedoch nicht aus dem öffentlichen Feed.
Plein-Moss-Cher ist nicht verantwortlich für etwaige Unstimmigkeiten in diesen Informationen.
Die Breiten-/Längengrade können durch die günstigere API korrigiert/angepasst werden, da sie inkonsistent oder ungenau sind.
plein-moins-cher ist vollständig auf den Open-Data-Dienst der Regierungswebsite prix-carburants.gouv.fr angewiesen.
Jede vorübergehende Nichtverfügbarkeit der Datenquelle wirkt sich auf den von der vollständig kostengünstigeren API bereitgestellten Dienst aus: Die zuletzt abgerufenen Informationen werden dann von der API zurückgegeben, bis der Dienst wiederhergestellt ist.
Im Falle einer dauerhaften Schließung des Open-Data-Dienstes der Website prix-carburants.gouv.fr wird die plein-moins-cher-API de facto nicht mehr funktionieren.
In diesem Fall würde jedes abgeschlossene Abonnement von plein-moins.cher geschlossen.
Der Abonnent kann keinen Anspruch geltend machen.
Die Nutzung des von plein-moins-cher bereitgestellten API-Dienstes setzt die Annahme dieser Haftungsbeschränkungen voraus.
API-Zugriff
– Die API ist über eine feste URL zugänglich, sicher und durch einen Token geschützt (ein Token ist ein digitaler Token).
- Der Zugriff ist zeitlich unbegrenzt, die API kann jederzeit angefordert werden.
- Es ist jedoch eine gleitende Höchstgrenze von 10 API-Aufrufen pro Minute aktiviert, um den Server vor böswilligem Datenverkehr zu schützen, der seine Funktion beeinträchtigen würde.
- Als Parameter muss ein gültiger Token übergeben werden, um den Preisinformationsfluss für alle Stationen zu erhalten.
- Ihr einzigartiger und persönlicher Token wird Ihnen auf Anfrage per E-Mail an pleinmoinscher@gmail.com zur Verfügung gestellt
Testtoken
- Mit dem Test-Token können Sie die API kostenlos testen.
- Das zurückgegebene Ergebnis enthält jedoch ein zufälliges, aber exaktes Spiel, das auf 50 Tankstellen beschränkt ist, die willkürlich aus den Tausenden verfügbaren Tankstellen ausgewählt wurden.
Zugriff auf die Test-API: https://api.geodateo.com/fuel/prices/v1?token=test
Lizenzpreis
- Ein einzigartiger privater Token wird auf Anfrage an pleinmoinscher@gmail.com bereitgestellt
- Dieser Token kann 1 Monat lang kostenlos genutzt werden, wobei die Gültigkeitsdauer ab dem Datum der ersten Nutzung des Tokens festgelegt wird
über die API https://api.geodateo.com/fuel/prices/v1?token=<token>
- Um den Dienst dauerhaft nutzen zu können, muss eine Lizenz bezahlt werden.
- Falls die Lizenz nicht abonniert wird, wird der bereitgestellte Token nach 1 Monat deaktiviert.
Um einen neuen Token zu erhalten, muss eine neue Anfrage bei Full-Cheaper gestellt werden.
Full-less-expensive behält sich dann das Recht vor, einen neuen Token auszugeben oder nicht.
- Der Preis der Lizenz beträgt 39 €/Monat und ist per Abonnement per Kreditkarte über die sichere Stripe-Plattform zu zahlen.
- Der Benutzer kann sein Abonnement jederzeit beenden über sein privates Stripe-Abrechnungsportal, dessen Link ihm beim Abonnement per E-Mail zugesandt wird.
- Jede Kündigung des Abonnements auf Initiative des Abonnenten führt zur dauerhaften Deaktivierung des Tokens.
– Es obliegt dem Abonnenten, dieses Token nicht offenzulegen.
– Der Abonnent kann diesen Token nicht teilen oder unterverkaufen.
- Die Zahlung erfolgt zugunsten von geodateo, Herausgeber der Website plein-moins-cher.fr
Abonnieren-API
- 100 % sichere Zahlung
- Preis wird monatlich berechnet
- 100 % transparent, keine versteckten Kosten
- Sie können sich jederzeit abmelden
API-Dokumentation
Anfrage
Der Zugriff auf die API erfolgt über die folgende URL:
https://api.geodateo.com/fuel/prices/v1?token=<token>&format= <format>&disposition=<disposition>
| Parameter |
Erforderlich |
Standardwert |
Mögliche Werte |
Beschreibung |
| token |
Ja |
- |
Ihr persönlicher Schlüssel oder „Test“ |
Ihr persönlicher Identifikationsschlüssel |
| format |
Nein |
json |
json | csv | xls |
Zurückgegebenes Format
json (JavaScript Object Notation): Web Data Interchange Format
csv (Comma-Separated Values): Excel-kompatibles Datenformat, bei dem Daten durch Semikolons getrennt sind
xls (Microsoft Excel): Excel-Datenformat
|
| disposition |
Nein |
inline |
inline | Anhang |
Bestimmt beim Aufruf der API über einen Webbrowser (Chrome, Firefox, Edge), ob der Inhalt auf der Seite angezeigt (inline) oder als hochgeladene Datei (Anhang) zurückgegeben wird.
Hinweis: Das Format „xls“ erfordert den Modus „Anhang“.
|
Testen Sie mit dem „Test“-Token das erhaltene Ergebnis: Die API stellt Echtzeit-Preisdaten für eine zufällige Gruppe von 50 Stationen bereit.
Test-URLs:
– Kehren Sie zum json-Format zurück
https://api.geodateo.com/fuel/prices/v1?token=test&format=json
(mit Datei angehängt: https://api.geodateo.com/fuel/prices/v1?token=test&format=json&disposition=attachment)
- Kehren Sie zum csv-Format zurück
https://api.geodateo.com/fuel/prices/v1?token=test&format=csv
- Kehren Sie zum xls-Format zurück
https://api.geodateo.com/fuel/prices/v1?token=test&format=xls
Antwort
Kraftstoffpreise
Die Informationen werden von der Tankstelle im folgenden Format zurückgegeben:
| Attribut |
Beschreibung |
Beispiel |
| brand |
Tankstellenmarke |
Esso |
| name |
Name der Tankstelle |
Station du bord de mer |
| postal_address |
Postanschrift der Tankstelle |
14 rue de la Gare |
| postal_code |
Postleitzahl |
24100 |
| city |
Name der Stadt |
Bergerac |
| department_code |
Abteilungscode |
24 |
| department_name |
Abteilungsname |
Dordogne |
| region |
Regionsname |
Nouvelle-Aquitaine |
| latitude |
Geografischer Breitengrad, zwischen -90° und +90° |
44.8581250 |
| longitude |
Geografischer Längengrad, zwischen -180° und +180° |
0.48215888 |
| gazole_price |
Dieselpreis, in Euro |
1.618 |
| gazole_update_date |
Datum/Uhrzeit der Aktualisierung des Dieselpreises |
2023-07-04 19:10:05 |
| e85_price |
E85-Ethanolpreis, in Euro |
1.049 |
| e85_update_date |
Datum/Uhrzeit der Preisaktualisierung für E85-Ethanol |
2023-07-04 09:31:03 |
| e10_price |
Preis für bleifreies 95-E10, in Euro |
1.784 |
| e10_update_date |
Datum/Uhrzeit der Preisaktualisierung für bleifreies Benzin 95-E10 |
2023-07-04 19:10:03 |
| sp95_price |
Preis für bleifreies 95, in Euro |
1.844 |
| sp95_update_date |
Datum/Uhrzeit aktualisieren
des Preises von bleifreiem 95 |
2023-07-04 19:22:13 |
| sp98_price |
Preis für bleifreies 98, in Euro |
1.774 |
| sp98_update_date |
Datum/Uhrzeit der Preisaktualisierung für Bleifrei 98 |
2023-07-04 18:18:15 |
| gplc_price |
LPG-Preis, in Euro |
1.884 |
| gplc_update_date |
Datum/Uhrzeit der LPG-Preisaktualisierung |
2023-07-04 18:07:46 |
Hinweise:
- Attribute in blue werden möglicherweise durch full-less-expensive angepasst oder korrigiert,
- Attribute in gelb werden von plein-cheaper hinzugefügt (da nicht im offiziellen Feed vorhanden),
- Die anderen Attribute stammen direkt aus dem Regierungsfluss, sie werden nicht transformiert.
format=csv
Gibt eine Tabelle mit Kopfzeile zurück, deren Daten durch Semikolons getrennt sind
Beispiel:
https://api.geodateo.com/fuel/prices/v1?token=test&format=csv
Mit angehängter Datei:
https://api.geodateo.com/fuel/prices/v1?token=test&format=csv&disposition=attachment
format=xls
Gibt eine mit Microsoft Excel kompatible Datei zurück
Beispiel:
https://api.geodateo.com/fuel/prices/v1?token=test&format=xls
format=json
Gibt eine JSON-Struktur zurück, die Folgendes enthält:
| Attribut |
Beschreibung |
| date_generated |
Datum/Uhrzeit der Stream-Generierung im Format JJJJ-MM-TT H24:MI:SS, Zeitzone Europa/Paris. Bsp.: 15.07.2023 21:05:05 |
| items |
Eine Reihe von Objekten, die Informationen nach Tankstelle anzeigen |
| context |
"token": das verwendete Token,
„date_requested“: Datum/Uhrzeit der Stream-Anfrage im Format JJJJ-MM-TT H24:MI:SS, Zeitzone Europa/Paris,
„originating_ip“: die aufrufende IP,
„token_first_utilisation_date“: das Datum der ersten Nutzung,
„token_validity“: das Gültigkeitsdatum (Datum der ersten Nutzung +1 Monat) oder „unbegrenzt“ im Falle einer kostenpflichtigen Lizenz. |
Beispiel:
https://api.geodateo.com/fuel/prices/v1?token=test&format=json
Mit angehängter Datei:
https://api.geodateo.com/fuel/prices/v1?token=test&format=json&disposition=attachment
HTTP-Antwortcodes
Liste der HTTP-Antwortcodes
| Code |
Beschreibung |
| 200 |
OK: Anfrage erfolgreich verarbeitet, ein Ergebnis wird zurückgegeben. |
| 400 |
Ungültige Anfrage: Die URL oder einer ihrer Parameter ist ungültig. |
| 401 |
Nicht autorisiert: Das verwendete Token ist ungültig. |
| 406 |
Nicht akzeptabel: Der Client muss die gzip-Kodierung akzeptieren (Accept-Encoding:gzip muss im Header der Anfrage vorhanden sein). |
| 429 |
Zu viele Anfragen: Nutzungslimit überschritten. Versuchen Sie die Anfrage später erneut. |
| 500 |
Interner Serverfehler: Ein interner Serverfehler ist aufgetreten. Versuchen Sie die Anfrage später erneut. |
Wichtiger Hinweis
Der Client muss die HTTP-Anfrage mit dem Header Accept-Encoding:gzip ausgeben
Dieser Header wird automatisch hinzugefügt, wenn die API über einen Webbrowser wie Chrome, Firefox oder Edge angefordert wird.
Andererseits muss es explizit angegeben werden, wenn die API über die Befehlszeile mit einem Tool wie curl aufgerufen wird:
Bei Abwesenheit wird eine Rückmeldung mit dem HTTP-Code 406 (Nicht akzeptabel) generiert.
API-Aufruf, gefolgt von Stream-Dekomprimierung:
curl -sH 'Accept-Encoding: gzip' https://api.geodateo.com/fuel/prices/v1?token=TEST | gunzip
