Plein-moins-cher API
plein-moins-cher offre un'API a pagamento che ti consente di recuperare i prezzi del carburante praticati dalle stazioni di servizio in Francia in tempo reale.
Dati relativi al flusso di dati
La fonte del flusso proviene dal sito governativo prix-carburants.gouv.fr, che fornisce dati sui prezzi del carburante praticati dalle stazioni di servizio in Francia quasi in tempo reale.
Il feed è adattato da plein-moins-cher al fine di arricchire il set di dati con i nomi e i marchi delle stazioni di servizio (dati non direttamente disponibili nel feed ufficiale).
Il flusso viene ricalcolato ogni 10 minuti circa per essere il più fedele possibile alle variazioni di prezzo praticate dalle stazioni di servizio una o più volte al giorno.
Limiti di responsabilità
Le informazioni sul prezzo e la relativa data/ora di aggiornamento per carburante, così come gli indirizzi postali dei punti vendita non vengono trasformate: vengono restituite come previsto dal sito governativo.
Anche i nomi e i marchi delle stazioni di servizio sono presi dal sito del governo, ma non provengono dal feed pubblico.
Plein-Moss-Cher non è responsabile per eventuali incongruenze in queste informazioni.
Le latitudini/longitudini possono essere corrette/adattate dall'API completa più economica perché sono incoerenti o imprecise.
plein-moins-cher dipende completamente dal servizio Open Data fornito dal sito governativo prix-carburants.gouv.fr.
L'eventuale indisponibilità temporanea dell'origine dati influisce sul servizio fornito dall'API full-meno costosa: l'ultima informazione recuperata viene quindi restituita dall'API, in attesa della restituzione del servizio.
In caso di chiusura permanente del servizio Open Data da parte del sito prix-carburants.gouv.fr, l'API plein-moins-cher cesserà di fatto di funzionare.
In questo caso, qualsiasi abbonamento sottoscritto verrebbe chiuso da plein-moins.cher.
L'abbonato non può avanzare pretese.
L'utilizzo del servizio API fornito da plein-moins-cher implica l'accettazione di questi limiti di responsabilità.
Accesso all'API
- L'API è accessibile su un URL fisso, sicuro e protetto da token (un token è un token digitale).
- L'accesso è illimitato nel tempo, l'API può essere richiesta in qualsiasi momento.
- Tuttavia, viene attivato un limite massimo scorrevole di 10 chiamate API al minuto, al fine di proteggere il server da qualsiasi traffico dannoso che ne impedirebbe il funzionamento.
- Deve essere passato come parametro un token valido per ottenere il flusso informativo sui prezzi relativo a tutte le postazioni.
- Il tuo token unico e personale viene fornito su richiesta, tramite e-mail a pleinmoinscher@gmail.com
Gettone di prova
- Il token test ti consente di testare l'API gratuitamente.
- Il risultato restituito contiene però un gioco casuale ma esatto limitato a 50 stazioni di servizio selezionate arbitrariamente tra le migliaia di stazioni disponibili.
Accesso all'API di test: https://api.geodateo.com/fuel/prices/v1?token=test
Prezzo della licenza
- Un tokenprivato univoco viene fornito su richiesta a pleinmoinscher@gmail.com
- Questo token può essere utilizzato gratuitamente per 1 mese, questo limite di validità è definito dalla data del primo utilizzo del token
tramite l'API https://api.geodateo.com/fuel/prices/v1?token=<token>
- Per beneficiare permanentemente del servizio è necessario pagare una licenza.
- In caso di mancata sottoscrizione della licenza, dopo 1 mese, il token fornito viene disattivato.
È necessario effettuare una nuova richiesta a prezzo pieno per ottenere un nuovo token.
Full-meno-costoso si riserverà quindi il diritto o meno di emettere un nuovo token.
- Il prezzo della licenza è fissato a € 39/mese, pagabile in abbonamento con carta di credito tramite la piattaforma sicura Stripe.
- L'utente può interrompere il suo abbonamento in qualsiasi momento tramite il suo portale di fatturazione Stripe privato, il cui collegamento verrà fornito via e-mail al momento dell'abbonamento.
- Qualsiasi risoluzione dell'abbonamento su iniziativa dell'abbonato disattiva permanentemente il token.
- Spetta all'abbonato non divulgare questo token.
- L'abbonato non può condividere questo token o svenderlo.
- Il pagamento viene effettuato a favore di geodateo, editore del sito plein-moins-cher.fr
API di sottoscrizione
- Pagamento sicuro al 100%
- Prezzo addebitato mensilmente
- 100% trasparente, senza costi nascosti
- Sei libero di annullare l'iscrizione in qualsiasi momento
Documentazione dell'API
Richiesta
L'accesso all'API avviene tramite il seguente URL:
https://api.geodateo.com/fuel/prices/v1?token=<token>&format=<format>&disposition=<disposition>
| Parametro |
Obbligatorio |
Valore predefinito |
Valori possibili |
Descrizione |
| token |
Sì |
- |
La tua chiave personale, o "test" |
La tua chiave di identificazione personale |
| format |
No |
json |
json | cv | xls |
Formato restituito
json (JavaScript Object Notation): formato di interscambio di dati Web
csv (Comma-Separated Values): formato di dati compatibile con Excel in cui i dati sono separati da punto e virgola
xls (Microsoft Excel): formato dati Excel
|
| disposition |
No |
in linea |
in linea | allegato |
Quando l'API viene richiamata tramite un browser Web (Chrome, Firefox, Edge), determina se il contenuto viene visualizzato nella pagina (in linea) o restituito come file caricato (allegato)
Nota: il formato "xls" impone la modalità "allegato".
|
Con il token "test", testa il risultato ottenuto: l'API fornisce dati sui prezzi in tempo reale per un insieme casuale di 50 stazioni.
URL di prova:
- Torna al formato json
https://api.geodateo.com/fuel/prices/v1?token=test&format=json
(con file allegato: https://api.geodateo.com/fuel/prices/v1?token=test&format=json&disposition=attachment)
- Torna al formato csv
https://api.geodateo.com/fuel/prices/v1?token=test&format=csv
- Torna al formato xls
https://api.geodateo.com/fuel/prices/v1?token=test&format=xls
Risposta
Prezzi del carburante
Le informazioni vengono restituite dalla stazione di servizio nel seguente formato:
| Attributo |
Descrizione |
Esempio |
| brand |
Marchio della stazione di servizio |
Esso |
| name |
Nome della stazione di servizio |
Località balneare |
| postal_address |
Indirizzo postale della stazione di servizio |
14 rue de la Gare |
| postal_code |
CAP |
24100 |
| city |
Nome città |
Bergerac |
| department_code |
Codice reparto |
24 |
| department_name |
Nome del dipartimento |
Dordogna |
| region |
Nome regione |
Nuova Aquitania |
| latitude |
Latitudine geografica, compresa tra -90° e +90° |
44.8581250 |
| longitude |
Longitudine geografica, tra -180° e +180° |
0.48215888 |
| gazole_price |
Prezzo diesel, in Euro |
1.618 |
| gazole_update_date |
Data/ora dell'aggiornamento del prezzo del diesel |
2023-07-04 19:10:05 |
| e85_price |
Prezzo dell'etanolo E85, in Euro |
1.049 |
| e85_update_date |
E85 Data/ora aggiornamento prezzo etanolo |
2023-07-04 09:31:03 |
| e10_price |
Prezzo della 95-E10 senza piombo, in Euro |
1.784 |
| e10_update_date |
Data/ora aggiornamento prezzo senza piombo 95-E10 |
2023-07-04 19:10:03 |
| sp95_price |
Prezzo della Senza Piombo 95, in Euro |
1.844 |
| sp95_update_date |
Aggiorna data/ora
del prezzo della benzina senza piombo 95 |
2023-07-04 19:22:13 |
| sp98_price |
Prezzo della Senza Piombo 98, in Euro |
1.774 |
| sp98_update_date |
Data/ora aggiornamento prezzo senza piombo 98 |
2023-07-04 18:18:15 |
| gplc_price |
Prezzo GPL, in Euro |
1.884 |
| gplc_update_date |
Data/ora aggiornamento prezzo GPL |
2023-07-04 18:07:46 |
Note:
- gli attributi in blu sono potenzialmente adattati o corretti da full-meno-costoso,
- gli attributi in giallo sono aggiunti da plein-cheaper (perché non presenti nel feed ufficiale),
- gli altri attributi provengono direttamente dal flusso governativo, non vengono trasformati.
format=csv
Restituisce una tabella con intestazione i cui dati sono separati da punto e virgola
Esempio:
https://api.geodateo.com/fuel/prices/v1?token=test&format=csv
Con file allegato:
https://api.geodateo.com/fuel/prices/v1?token=test&format=csv&disposition=attachment
format=xls
Restituisce un file compatibile con Microsoft Excel
Esempio:
https://api.geodateo.com/fuel/prices/v1?token=test&format=xls
format=json
Restituisce una struttura json contenente:
| Attributo |
Descrizione |
| date_generated |
Data/Ora di generazione del flusso nel formato AAAA-MM-GG H24:MI:SS, nel fuso orario Europa/Parigi. Es: 2023-07-15 21:05:05 |
| items |
Una serie di oggetti che mostrano informazioni per stazione di servizio |
| context |
"token": il token utilizzato,
"date_requested": data/ora della richiesta di streaming in formato AAAA-MM-GG H24:MI:SS, in TimeZone Europe/Paris,
"originating_ip": l'IP chiamante,
"token_first_utilisation_date": la data del primo utilizzo,
"token_validity": la data di validità (data del primo utilizzo +1 mese) o "illimitata" in caso di licenza a pagamento. |
Esempio:
https://api.geodateo.com/fuel/prices/v1?token=test&format=json
Con file allegato:
https://api.geodateo.com/fuel/prices/v1?token=test&format=json&disposition=attachment
Codici di risposta HTTP
Elenco dei codici di risposta HTTP
| Codice |
Descrizione |
| 200 |
OK: richiesta elaborata correttamente, viene restituito un risultato. |
| 400 |
Richiesta errata: l'URL o uno dei suoi parametri non è valido. |
| 401 |
Non autorizzato: il token utilizzato non è valido. |
| 406 |
Non accettabile: il client deve accettare la codifica gzip (Accept-Encoding:gzip deve essere presente nell'intestazione della richiesta). |
| 429 |
Troppe richieste: limite di utilizzo superato. Riprova la richiesta più tardi. |
| 500 |
Errore interno del server: si è verificato un errore interno del server. Riprova la richiesta più tardi. |
Nota importante
Il client deve emettere la richiesta HTTP con l'intestazione Accept-Encoding:gzip
Questa intestazione viene aggiunta automaticamente quando l'API viene richiesta tramite un browser Web come Chrome, Firefox o Edge.
D'altra parte, deve essere specificato esplicitamente quando l'API viene richiamata dalla riga di comando con uno strumento come curl:
In caso di assenza viene generato un reso con codice HTTP 406 (Non accettabile).
Chiamata API, seguita dalla decompressione del flusso:
curl -sH 'Accept-Encoding: gzip' https://api.geodateo.com/fuel/prices/v1?token=TEST | gunzip
