es
EN FR DE NL ES IT
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 - 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
Información legal Política de privacidad Pagina de inicio ©2023