Documentación API

Extrae datos por estación y agregados con reglas claras de facturación.

La API comercial está diseñada para solicitudes autenticadas por cuenta de cliente. Los compradores pueden consultar estaciones actuales, histórico por estación o medias por marca, ubicación, combustible y periodo.

Ver precios Contactar ventas

AutenticaciónCada extracción comercial usa una clave API vinculada a organización y suscripción.

CuotaLas respuestas de datos correctas y facturables cuentan dentro del paquete mensual.

ProtecciónCobertura ausente, parámetros inválidos e histórico no disponible deben fallar antes de facturar.

Patrones de extracción soportados

La API se organiza alrededor de las preguntas habituales de clientes. Las definiciones de campos y contratos detallados se comparten en privado tras la cualificación.

Fila estación

Datos de estación por estación o mercado filtrado.

Usa extracciones por estación para observaciones actuales por estación conocida, ciudad, código postal, país o zona.

Identificador de estaciónCiudad o código postalPaís y combustibleZona delimitada

Histórico

Histórico de estación con comprobación de disponibilidad.

Solicita una ventana temporal. La API debe confirmar cobertura antes de contar la solicitud.

Fechas inicio y finHistórico diario recienteDisponibilidad paísHistórico no disponible sin cargo

Agregados

Precios medios por marca, ubicación y tiempo.

Usa agregados para medias diarias o semanales por marca, ciudad, código postal, región, país o combustible.

Media de marcaMedia por ciudad o código postalMedia semanal de mercadoTendencia país

Cómo se hace una solicitud

Las solicitudes comerciales usan HTTPS, clave API, país acotado y filtros explícitos. El contrato exacto se facilita en el portal tras aprobación.

1Elegir datos por estación o agregados de mercado.

2Enviar país, combustible, filtros de ubicación o marca y periodo opcional.

3Usar validación previa para confirmar cobertura antes de una extracción facturable.

4Solo respuestas de datos correctas cuentan para cuota o exceso.

Seguridad de facturación y cuota

La regla objetivo es simple: el cliente paga por acceso correcto a datos, no por errores, mercados ausentes o histórico no soportado.

Cuenta en la cuota

Solicitud autenticada devuelve datos actuales de estación.
Solicitud autenticada devuelve histórico disponible.
Solicitud autenticada devuelve agregado para mercado y periodo soportados.

No cuenta

Clave API ausente o inválida.
Parámetros inválidos o filtros no soportados.
País, ciudad, estación, marca o histórico no disponible.
Solicitud validada sin datos soportados.
Fallo servidor antes de una respuesta usable.

Lo que falta aplicar en la API

Cuenta, precios y checkout están en vivo. El siguiente paso backend es validar claves API, contar uso y reportar exceso a Stripe.

Claves API vinculadas a derechos de organizaciónContadores mensuales por clave y suscripciónValidaciones previas no facturablesReporte de exceso solo tras superar la cuota

Ver precios