Plein-moins-cher API
plein-moins-cher ofrece una API de pago que le permite recuperar los precios de combustible que cobran las estaciones de servicio en Francia en tiempo real.
Datos relacionados con el flujo de datos
La fuente del flujo proviene del sitio del gobierno prix-carburants.gouv.fr, que proporciona datos sobre los precios del combustible que cobran las estaciones de servicio en Francia casi en tiempo real.
El feed está adaptado por plein-moins-cher para enriquecer el conjunto de datos con los Nombres y Marcas de las estaciones de servicio (datos no disponibles directamente en el feed oficial).
El caudal se recalcula aproximadamente cada 10 minutos para ser lo más fiel posible a las variaciones de precios que practican las estaciones de servicio una o varias veces al día.
Límites de responsabilidad
La información de precios y su fecha/hora de actualización por combustible, así como las direcciones postales de los puntos de venta no se transforman: se devuelven tal como las proporciona el sitio del gobierno.
Los nombres y marcas de las estaciones de servicio también se toman del sitio del gobierno, pero no provienen del feed público.
Plein-Moss-Cher no es responsable de posibles inconsistencias en esta información.
Las latitudes/longitudes pueden ser corregidas/adaptadas por la API más económica porque son inconsistentes o inexactas.
plein-moins-cher depende totalmente del servicio Open Data proporcionado por el sitio web del gobierno prix-carburants.gouv.fr.
Cualquier falta de disponibilidad temporal de la fuente de datos afecta el servicio proporcionado por la API completa y menos costosa: la API devuelve la última información recuperada, a la espera de la devolución del servicio.
En caso de cierre permanente del servicio Open Data por parte del sitio web prix-carburants.gouv.fr, la API de plein-moins-cher dejará de funcionar de facto.
En este caso, plein-moins.cher cerraría cualquier suscripción contratada.
El suscriptor no puede hacer una reclamación.
El uso del servicio API proporcionado por plein-moins-cher implica la aceptación de estos límites de responsabilidad.
Acceso API
- Se puede acceder a la API en una URL fija, segura y protegida por token (un token es un token digital).
- El acceso es ilimitado en el tiempo, la API se puede solicitar en cualquier momento.
- Sin embargo, se activa un límite máximo móvil de 10 llamadas API por minuto, con el fin de proteger el servidor de cualquier tráfico malicioso que impida su funcionamiento.
- Se debe pasar un token válido como parámetro para obtener el flujo de información de precios relativo a todas las estaciones.
- Su token único y personal se proporciona a pedido, por correo electrónico a pleinmoinscher@gmail.com
Ficha de prueba
- El token test le permite probar la API de forma gratuita.
- El resultado devuelto contiene sin embargo un juego aleatorio pero exacto limitado a 50 estaciones de servicio seleccionadas arbitrariamente entre las miles de estaciones disponibles.
Acceso a la API de prueba: https://api.geodateo.com/fuel/prices/v1?token=test
Precio de la licencia
- Se proporciona un privado token único a pedido a pleinmoinscher@gmail.com
- Este token se puede utilizar gratis durante 1 mes, siendo este límite de validez definido a partir de la fecha del primer uso del token
a través de la API https://api.geodateo.com/fuel/prices/v1?token=<token>
- Se debe pagar una licencia para disfrutar permanentemente del servicio.
- En caso de no suscripción de la licencia, después de 1 mes, el token proporcionado se desactiva.
Se debe realizar una nueva solicitud a precio más bajo para obtener un nuevo token.
Full-less-expensive se reservará el derecho de emitir o no un nuevo token.
- El precio de la licencia está fijado en 39€/mes, pagadero mediante suscripción con tarjeta de crédito a través de la plataforma segura Stripe.
- El usuario puede cancelar su suscripción en cualquier momento a través de su portal privado de facturación Stripe, cuyo enlace le será proporcionado por correo electrónico al momento de la suscripción.
- Cualquier terminación de suscripción por iniciativa del suscriptor desactiva permanentemente el token.
- Depende del suscriptor no divulgar este token.
- El suscriptor no puede compartir este token ni venderlo a menor precio.
- El pago se realiza en beneficio de geodateo, editor del sitio web plein-moins-cher.fr
API de suscripción
- Pago 100 % seguro
- Precio cobrado mensualmente
- 100 % transparente, sin costes ocultos
- Puede cancelar su suscripción en cualquier momento
Documentación API
Solicitud
El acceso a la API se realiza a través de la siguiente URL:
https://api.geodateo.com/fuel/prices/v1?token=<token>&formato= <formato>&diseño=<diseño>
| Parámetro |
Obligatorio |
Valor predeterminado |
Valores posibles |
Descripción |
| ficha |
Sí |
- |
Su clave personal, o "prueba" |
Su clave de identificación personal |
| formato |
No |
json |
json | CSV | xls |
Formato devuelto
json (notación de objetos de JavaScript): formato de intercambio de datos web
csv (valores separados por comas): formato de datos compatible con Excel donde los datos están separados por punto y coma
xls (Microsoft Excel): formato de datos de Excel
|
| diseño |
No |
en línea |
en línea | adjunto |
Cuando se llama a la API a través de un navegador web (Chrome, Firefox, Edge), determina si el contenido se muestra en la página (en línea) o se devuelve como un archivo cargado (adjunto)
Nota: el formato "xls" impone el modo "adjunto".
|
Con el token de "prueba", pruebe el resultado obtenido: la API proporciona datos de precios en tiempo real para un conjunto aleatorio de 50 estaciones.
URL de prueba:
- Volver al formato json
https://api.geodateo.com/fuel/prices/v1?token=test&format=json
(con archivo adjunto: https://api.geodateo.com/fuel/prices/v1?token=test&format=json&disposition=attachment)
- Volver al formato csv
https://api.geodateo.com/fuel/prices/v1?token=test&format=csv
- Volver al formato xls
https://api.geodateo.com/fuel/prices/v1?token=test&format=xls
Respuesta
Precios del combustible
La información es devuelta por estación de servicio en el siguiente formato:
| Atributo |
Descripción |
Ejemplo |
| marca |
Marca de la gasolinera |
Eso |
| nombre |
Nombre de la gasolinera |
Balneario |
| dirección_postal |
Dirección postal de la estación de servicio |
14 rue de la Gare |
| código_postal |
Código postal |
24100 |
| ciudad |
Nombre de la ciudad |
Bergerac |
| código_departamento |
Código de departamento |
24 |
| nombre_departamento |
Nombre del departamento |
Dordoña |
| región |
Nombre de la región |
Nueva Aquitania |
| latitud |
Latitud geográfica, entre -90° y +90° |
44.8581250 |
| longitud |
Longitud geográfica, entre -180° y +180° |
0,48215888 |
| precio_diesel |
Precio del diésel, en euros |
1.618 |
| diésel_actualización_fecha |
Fecha/hora de la actualización del precio del diesel |
2023-07-04 19:10:05 |
| e85_price |
Precio del etanol E85, en euros |
1.049 |
| e85_update_date |
E85 Fecha/hora de actualización del precio del etanol |
2023-07-04 09:31:03 |
| e10_price |
Precio de 95-E10 sin plomo, en euros |
1.784 |
| e10_update_date |
95-E10 Fecha y hora de actualización del precio de gasolina sin plomo |
2023-07-04 19:10:03 |
| sp95_precio |
Precio de la gasolina 95 sin plomo, en euros |
1.844 |
| sp95_update_date |
Actualizar fecha/hora
del precio de la Sin Plomo 95 |
2023-07-04 19:22:13 |
| sp98_precio |
Precio del 98 sin plomo, en euros |
1.774 |
| sp98_update_date |
Fecha y hora de actualización del precio de la gasolina 98 sin plomo |
2023-07-04 18:18:15 |
| precio_gplc |
Precio del GLP, en Euros |
1.884 |
| gplc_update_date |
Fecha/hora de actualización del precio del GLP |
2023-07-04 18:07:46 |
Notas:
- los atributos en azul son potencialmente adaptados o corregidos por completo-menos-costoso,
- los atributos en amarillo son agregados por plein-cheaper (porque no están presentes en el feed oficial),
- los demás atributos provienen directamente del flujo de gobierno, no se transforman.
formato=csv
Devuelve una tabla con encabezado cuyos datos están separados por punto y coma
Ejemplo:
https://api.geodateo.com/fuel/prices/v1?token=test&format=csv
Con archivo adjunto:
https://api.geodateo.com/fuel/prices/v1?token=test&format=csv&disposition=attachment
formato=xls
Devuelve un archivo compatible con Microsoft Excel
Ejemplo:
https://api.geodateo.com/fuel/prices/v1?token=test&format=xls
formato=json
Devuelve una estructura json que contiene:
| Atributo |
Descripción |
| fecha_generado |
Fecha/Hora de generación de transmisión en formato AAAA-MM-DD H24:MI:SS, en TimeZone Europe/Paris. Ej: 2023-07-15 21:05:05 |
| elementos |
Una serie de objetos que muestran información por gasolinera |
| contexto |
"token": el token utilizado,
"date_requested": fecha/hora de la solicitud de transmisión en formato AAAA-MM-DD H24:MI:SS, en TimeZone Europe/Paris,
"originating_ip": la IP que llama,
"token_first_utilisation_date": la fecha del primer uso,
"token_validity": la fecha de validez (fecha del primer uso +1 mes) o "ilimitada" en caso de licencia paga. |
Ejemplo:
https://api.geodateo.com/fuel/prices/v1?token=test&format=json
Con archivo adjunto:
https://api.geodateo.com/fuel/prices/v1?token=test&format=json&disposition=attachment
Códigos de respuesta HTTP
Lista de códigos de respuesta HTTP
| Código |
Descripción |
| 200 |
OK: solicitud procesada con éxito, se devuelve un resultado. |
| 400 |
Solicitud incorrecta: la URL o uno de sus parámetros no es válido. |
| 401 |
No autorizado: el token utilizado no es válido. |
| 406 |
No aceptable: el cliente debe aceptar la codificación gzip (Accept-Encoding:gzip debe estar presente en el encabezado de la solicitud). |
| 429 |
Demasiadas solicitudes: se excedió el límite de uso. Vuelva a intentar la solicitud más tarde. |
| 500 |
Error de servidor interno: Se ha producido un error de servidor interno. Vuelva a intentar la solicitud más tarde. |
Nota importante
El cliente debe emitir la solicitud HTTP con el encabezado Accept-Encoding:gzip
Este encabezado se agrega automáticamente cuando se solicita la API a través de un navegador web como Chrome, Firefox o Edge.
Por otro lado, debe especificarse explícitamente cuando se llama a la API desde la línea de comandos con una herramienta como curl:
En caso de ausencia, se genera una devolución con el código HTTP 406 (No aceptable).
Llamada API, seguida de descompresión de flujo:
curl -sH 'Accept-Encoding: gzip' https://api.geodateo.com/fuel/prices/v1?token=TEST | gunzip
