API de precioil.es


SERVICIO EN PRUEBAS

API de precioil.es. A continuación, encontrarás una descripción de los endpoints disponibles y cómo utilizarlos.

Endpoints Disponibles


Obtener Todas las Estaciones con Paginación

GET /estaciones?limit={limit}&offset={offset}

Este endpoint retorna todas las estaciones disponibles en la base de datos. Puedes especificar el número de estaciones a devolver (limit) y el punto de inicio para la consulta (offset). Por defecto, limit es 10 y offset es 0.

Ejemplo: /estaciones?limit=5&offset=10 para obtener 5 estaciones, empezando con la estación número 11 (considerando que la primera estación tiene el índice 0).

Obtener Estaciones con precios de los principales combustibles por Municipio

GET /estaciones/municipio/{idMunicipio}

Retorna todas las estaciones en el municipio especificado mediante su ID.

Obtener Precios Medios por Provincia y Tipo de Combustible

GET /precio/medio/provincia?provincias={idProvincias}&combustibles={idCombustibles}

Este endpoint retorna los precios medios de combustibles para las provincias y tipos de combustibles especificados. Los parámetros provincias y combustibles deben ser arrays.

Ejemplo: /precio/medio/provincia?provincias=1&provincias=2&combustibles=13&combustibles=8 para obtener los precios medios de los tipos de combustibles 13 y 8 en las provincias con ID 1 y 2. O /precio/medio/provincia?provincias[]=1&combustibles[]=6

Historial de Precios de una Estación

GET /estaciones/historico/:idEstacion

Retorna el historial de precios de combustible para una estación específica, dentro de un rango de fechas.

Ejemplo: /estaciones/historico/1?fechaInicio=2023-12-01&fechaFin=2023-12-31 para obtener el historial de precios de la estación con ID 1 entre esas fechas.

Detalles y precios principales combustibles de una Estación

GET /estaciones/detalles/:idEstacion

Este endpoint proporciona detalles de una estación específica, incluyendo tipos de combustible y precios.

Ejemplo: /estaciones/detalles/2 para obtener detalles de la estación con ID .

Obtener Localidades de una Provincia Específica

GET /localidades/provincia/{idProvincia}

Retorna todas las localidades pertenecientes a la provincia especificada por su ID.

Obtener Estaciones con Precios Principales de Combustibles en un Radio Determinado

GET /estaciones/radio?latitud={lat}&longitud={long}&radio={km}&pagina={pagina}&limite={limite}

Retorna estaciones dentro de un radio especificado en kilómetros alrededor de una latitud y longitud dadas, junto con los precios principales de combustibles. Además, permite especificar la paginación y el límite de estaciones a retornar por petición.

Los parámetros pagina y limite son opcionales, donde pagina indica el número de página en los resultados y limite la cantidad máxima de estaciones a mostrar por página. Por defecto, pagina es 1 y limite es 10.

Ejemplo: /estaciones/radio?latitud=40.416775&longitud=-3.703790&radio=30&pagina=2&limite=5 para obtener las estaciones en un radio de 30 kilómetros alrededor de las coordenadas dadas, mostrando la segunda página de resultados con un límite de 5 estaciones por página.

Obtener Estaciones con Precios de Combustibles en una Localidad Específica

GET /estaciones/conPrecios/localidad/{localidad}

Retorna todas las estaciones con sus precios y nombres de combustibles en la localidad especificada.

Obtener Localidades Cercanas por ID de Estación

GET /estaciones/cercanas/{idEstacion}

Retorna estaciones cercanas a la estación especificada por su ID, dentro de un radio de 20 kilómetros.

Servicio para obterner información sobre gasolineras y precios de combustibles de España

Para más información contacto@precioil.es