Finanzas personales de fintech Precios de combustible API

API ID 12771

Integra datos de finanzas personales y precios de combustible sin problemas con nuestra API de Precios de Combustible de Finanzas Personales Fintech

Documentación de la API

Endpoints

Solicitud
Devuelve los precios oficiales de los combustibles de este mes para todos los tipos de combustible y ambas regiones. Los precios se obtienen del DMRE y se actualizan automáticamente cada mes No se requieren parámetros. Devuelve los precios de Gasolina 93, Gasolina 95 y Diésel 50ppm para las regiones de interior y costeras en ZAR por litro
Endpoint ID: 24973
GET https://zylalabs.com/api/12771/fintech+personal+finance+fuel+pricing+api/24973/get+latest+prices
PARÁMETROS DE ENTRADA

Pruebas gratuitas restantes: 3 de 3.

Este endpoint no requiere parámetros de entrada.

RESPUESTA DE EJEMPLO DE LA API
JSON
{"success":true,"data":{"year":2026,"month":6,"prices":{"diesel_50ppm":{"coastal":28,"inland":29.26},"petrol_93":{"coastal":27.16,"inland":27.95},"petrol_95":{"coastal":27.19,"inland":28.06}}},"meta":{"effective_date":"2026-06-03","next_update":"2026-07-01","cached":false}}
Obtener precios más recientes — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12771/fintech+personal+finance+fuel+pricing+api/24973/get+latest+prices' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud
Devuelve el precio de un solo tipo de combustible y región para el mes actual Cuando su aplicación solo necesita un precio de combustible específico en lugar de un conjunto completo de precios use este punto final Parámetros de URL: - tipo_de_combustible (obligatorio): tipo de combustible a recuperar. Valores aceptables: gasolina_93, gasolina_95, diésel_50ppm, queroseno. Ejemplo: gasolina_95 - región (obligatorio): región para recuperar precios. Valores aceptables: interior, costera. Ejemplo: interior
Endpoint ID: 24974
GET https://zylalabs.com/api/12771/fintech+personal+finance+fuel+pricing+api/24974/get+latest+price+-+single+fuel+type
PARÁMETROS DE ENTRADA

Pruebas gratuitas restantes: 3 de 3.

RESPUESTA DE EJEMPLO DE LA API
JSON
{"success":true,"data":{"year":2026,"month":6,"fuel_type":"petrol_95","region":"inland","price_zar":28.06,"effective_date":"2026-06-03"},"meta":{"next_update":"2026-07-01","cached":false}}
Obtener el precio más reciente - Tipo de combustible único — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12771/fintech+personal+finance+fuel+pricing+api/24974/get+latest+price+-+single+fuel+type&fuel_type=Required&/=Required®ion=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud

Devuelve el historial completo de precios desde enero de 2008 hasta el presente, el más reciente primero. Filtra por tipo de combustible y región utilizando parámetros de consulta opcionales. Si no se aplican filtros, se devuelven todos los tipos de combustible y ambas regiones. Parámetros de consulta: - tipo_combustible (opcional): Filtra por tipo de combustible. Valores aceptados: gasolina_93, gasolina_95, diésel_50ppm, queroseno. Ejemplo: gasolina_95. - región (opcional): Filtra por región. Valores aceptados: interior, costera. Ejemplo: interior.

Endpoint ID: 24975
GET https://zylalabs.com/api/12771/fintech+personal+finance+fuel+pricing+api/24975/get+price+history
PARÁMETROS DE ENTRADA

Obtener historial de precios — Características del Endpoint

Objeto Descripción
fuel_type Opcional Optional. Filter by fuel type. Accepted values: petrol_93, petrol_95, diesel_50ppm, paraffin.
region Opcional Optional. Filter by region. Accepted values: inland, coastal.

Pruebas gratuitas restantes: 3 de 3.


PARÁMETROS DE ENTRADA

fuel_type
region
RESPUESTA DE EJEMPLO DE LA API
JSON
{
  "success": true,
  "data": [
    {
      "year": 2026,
      "month": 6,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 28.06,
      "effective_date": "2026-06-03"
    },
    {
      "year": 2026,
      "month": 5,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 26.63,
      "effective_date": "2026-05-06"
    },
    {
      "year": 2026,
      "month": 4,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 23.36,
      "effective_date": "2026-04-01"
    },
    {
      "year": 2026,
      "month": 3,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 20.3,
      "effective_date": "2026-03-04"
    },
    {
      "year": 2026,
      "month": 2,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 20.1,
      "effective_date": "2026-02-04"
    },
    {
      "year": 2026,
      "month": 1,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 20.75,
      "effective_date": "2026-01-07"
    },
    {
      "year": 2025,
      "month": 12,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.41,
      "effective_date": "2025-12-03"
    },
    {
      "year": 2025,
      "month": 11,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.12,
      "effective_date": "2025-11-05"
    },
    {
      "year": 2025,
      "month": 10,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.63,
      "effective_date": "2025-10-01"
    },
    {
      "year": 2025,
      "month": 9,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.55,
      "effective_date": "2025-09-03"
    },
    {
      "year": 2025,
      "month": 8,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.59,
      "effective_date": "2025-08-06"
    },
    {
      "year": 2025,
      "month": 7,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.87,
      "effective_date": "2025-07-02"
    },
    {
      "year": 2025,
      "month": 6,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.35,
      "effective_date": "2025-06-04"
    },
    {
      "year": 2025,
      "month": 5,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.4,
      "effective_date": "2025-05-07"
    },
    {
      "year": 2025,
      "month": 4,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.62,
      "effective_date": "2025-04-02"
    },
    {
      "year": 2025,
      "month": 3,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 22.34,
      "effective_date": "2025-03-05"
    },
    {
      "year": 2025,
      "month": 2,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 22.41,
      "effective_date": "2025-02-05"
    },
    {
      "year": 2025,
      "month": 1,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.59,
      "effective_date": "2025-01-01"
    },
    {
      "year": 2024,
      "month": 12,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.47,
      "effective_date": "2024-12-04"
    },
    {
      "year": 2024,
      "month": 11,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.3,
      "effective_date": "2024-11-06"
    },
    {
      "year": 2024,
      "month": 10,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.05,
      "effective_date": "2024-10-02"
    },
    {
      "year": 2024,
      "month": 9,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 22.19,
      "effective_date": "2024-09-04"
    },
    {
      "year": 2024,
      "month": 8,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 23.11,
      "effective_date": "2024-08-07"
    },
    {
      "year": 2024,
      "month": 7,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 23.26,
      "effective_date": "2024-07-03"
    },
    {
      "year": 2024,
      "month": 6,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 24.25,
      "effective_date": "2024-06-05"
    },
    {
      "year": 2024,
      "month": 5,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 25.49,
      "effective_date": "2024-05-01"
    },
    {
      "year": 2024,
      "month": 4,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 25.12,
      "effective_date": "2024-04-03"
    },
    {
      "year": 2024,
      "month": 3,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 24.45,
      "effective_date": "2024-03-06"
    },
    {
      "year": 2024,
      "month": 2,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 23.24,
      "effective_date": "2024-02-07"
    },
    {
      "year": 2024,
      "month": 1,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 22.49,
      "effective_date": "2024-01-03"
    },
    {
      "year": 2023,
      "month": 12,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 23.25,
      "effective_date": "2023-12-06"
    },
    {
      "year": 2023,
      "month": 11,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 23.9,
      "effective_date": "2023-11-01"
    },
    {
      "year": 2023,
      "month": 10,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 25.68,
      "effective_date": "2023-10-04"
    },
    {
      "year": 2023,
      "month": 9,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 24.54,
      "effective_date": "2023-09-06"
    },
    {
      "year": 2023,
      "month": 8,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 22.83,
      "effective_date": "2023-08-02"
    },
    {
      "year": 2023,
      "month": 7,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 22.46,
      "effective_date": "2023-07-06"
    },
    {
      "year": 2023,
      "month": 6,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 22.63,
      "effective_date": "2023-06-07"
    },
    {
      "year": 2023,
      "month": 5,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 23.34,
      "effective_date": "2023-05-03"
    },
    {
      "year": 2023,
      "month": 4,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 22.97,
      "effective_date": "2023-04-05"
    },
    {
      "year": 2023,
      "month": 3,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 22.95,
      "effective_date": "2023-03-01"
    },
    {
      "year": 2023,
      "month": 2,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.68,
      "effective_date": "2023-02-01"
    },
    {
      "year": 2023,
      "month": 1,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.4,
      "effective_date": "2023-01-04"
    }
],
  "meta": {
    "count": 217,
    "filters": {
      "fuel_type": "petrol_95",
      "region": "inland"
    },
    "next_update": "2026-07-01",
    "cached": false
  }
}
Obtener historial de precios — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12771/fintech+personal+finance+fuel+pricing+api/24975/get+price+history?fuel_type=petrol_95®ion=inland' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud
Devuelve todos los precios del combustible para un mes y año específicos. Devuelve un 404 si no existen datos para el período solicitado. Los datos están disponibles desde enero de 2008 hasta la actualidad Parámetros de URL: - año (requerido): El año para recuperar precios. Debe ser un año de 4 dígitos entre 2008 y el año actual. Ejemplo: 2024 - mes (requerido): El mes para recuperar precios. Debe ser un número entre 1 y 12. Ejemplo: 3
Endpoint ID: 24976
GET https://zylalabs.com/api/12771/fintech+personal+finance+fuel+pricing+api/24976/get+price+by+month
PARÁMETROS DE ENTRADA

Pruebas gratuitas restantes: 3 de 3.

RESPUESTA DE EJEMPLO DE LA API
JSON
{"success":true,"data":{"year":2024,"month":3,"prices":{"diesel_50ppm":{"coastal":21.93,"inland":22.62},"petrol_93":{"coastal":23.41,"inland":24.13},"petrol_95":{"coastal":23.73,"inland":24.45}}},"meta":{"effective_date":"2024-03-06","next_update":"2024-04-03","cached":false}}
Obtener precio por mes — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12771/fintech+personal+finance+fuel+pricing+api/24976/get+price+by+month&year=Required&/=Required&month=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud

Devuelve los últimos N meses de precios para un solo tipo de combustible y región, siendo el más reciente primero. Cada registro incluye el cambio de precio mes a mes en ZAR y como porcentaje. Ideal para gráficos, tableros de control y análisis de tendencias. Parámetros de consulta: - tipo_combustible (requerido): El tipo de combustible para el que se recuperarán los datos de tendencia. Valores aceptados: gasolina_93, gasolina_95, diésel_50ppm, parafina. Ejemplo: gasolina_95. - región (requerido): La región para la que se recuperarán los datos de tendencia. Valores aceptados: interior, costera. Ejemplo: interior. - meses (opcional): Número de meses a devolver. Debe estar entre 1 y 60. Por defecto es 12 si no se proporciona. Ejemplo: 12.

Endpoint ID: 24977
GET https://zylalabs.com/api/12771/fintech+personal+finance+fuel+pricing+api/24977/get+price+trend
PARÁMETROS DE ENTRADA

Obtener tendencia de precios — Características del Endpoint

Objeto Descripción
fuel_type Requerido Required. The fuel type to retrieve trend data for. Accepted values: petrol_93, petrol_95, diesel_50ppm, paraffin.
region Requerido Required. The region to retrieve trend data for. Accepted values: inland, coastal.
months Requerido Optional. Number of months to return. Must be between 1 and 60. Defaults to 12.

Pruebas gratuitas restantes: 3 de 3.


PARÁMETROS DE ENTRADA

fuel_type
region
months
RESPUESTA DE EJEMPLO DE LA API
JSON
{"success":true,"data":[{"year":2026,"month":6,"price_zar":28.06,"effective_date":"2026-06-03","change_zar":1.43,"change_pct":5.37},{"year":2026,"month":5,"price_zar":26.63,"effective_date":"2026-05-06","change_zar":3.27,"change_pct":14},{"year":2026,"month":4,"price_zar":23.36,"effective_date":"2026-04-01","change_zar":3.06,"change_pct":15.07},{"year":2026,"month":3,"price_zar":20.3,"effective_date":"2026-03-04","change_zar":0.2,"change_pct":1},{"year":2026,"month":2,"price_zar":20.1,"effective_date":"2026-02-04","change_zar":-0.65,"change_pct":-3.13},{"year":2026,"month":1,"price_zar":20.75,"effective_date":"2026-01-07","change_zar":-0.66,"change_pct":-3.08},{"year":2025,"month":12,"price_zar":21.41,"effective_date":"2025-12-03","change_zar":0.29,"change_pct":1.37},{"year":2025,"month":11,"price_zar":21.12,"effective_date":"2025-11-05","change_zar":-0.51,"change_pct":-2.36},{"year":2025,"month":10,"price_zar":21.63,"effective_date":"2025-10-01","change_zar":0.08,"change_pct":0.37},{"year":2025,"month":9,"price_zar":21.55,"effective_date":"2025-09-03","change_zar":-0.04,"change_pct":-0.19},{"year":2025,"month":8,"price_zar":21.59,"effective_date":"2025-08-06","change_zar":-0.28,"change_pct":-1.28},{"year":2025,"month":7,"price_zar":21.87,"effective_date":"2025-07-02","change_zar":null,"change_pct":null}],"meta":{"fuel_type":"petrol_95","region":"inland","months":12,"cached":false}}
Obtener tendencia de precios — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12771/fintech+personal+finance+fuel+pricing+api/24977/get+price+trend?fuel_type=petrol_95®ion=inland&months=12' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud

Compara el precio de un tipo de combustible y región entre dos meses especificados. Devuelve el precio en ambos momentos en el tiempo junto con el cambio en ZAR y como porcentaje. Útil para análisis de costos, informes presupuestarios y planificación financiera. Parámetros de consulta: - tipo_combustible (requerido): El tipo de combustible a comparar. Valores aceptados: gasolina_93, gasolina_95, diésel_50ppm, queroseno. Ejemplo: gasolina_95. - región (requerido): La región para comparar precios. Valores aceptados: interior, costa. Ejemplo: interior. - desde (requerido): El mes de inicio para la comparación en formato AAAA-MM. Ejemplo: 2020-01. - hasta (requerido): El mes final para la comparación en formato AAAA-MM. Ejemplo: 2026-05.

Endpoint ID: 24978
GET https://zylalabs.com/api/12771/fintech+personal+finance+fuel+pricing+api/24978/compare+prices+between+two+months
PARÁMETROS DE ENTRADA

Comparar precios entre dos meses — Características del Endpoint

Objeto Descripción
fuel_type Requerido Required. The fuel type to compare. Accepted values: petrol_93, petrol_95, diesel_50ppm, paraffin.
region Requerido Required. The region to compare prices for. Accepted values: inland, coastal.
from Requerido Required. Start month in YYYY-MM format. Example: 2020-01.
to Requerido Required. End month in YYYY-MM format. Example: 2026-05.

Pruebas gratuitas restantes: 3 de 3.


PARÁMETROS DE ENTRADA

fuel_type
region
from
to
RESPUESTA DE EJEMPLO DE LA API
JSON
{"success":true,"data":{"fuel_type":"petrol_95","region":"inland","from":{"year":2020,"month":1,"price_zar":16.16,"effective_date":"2020-01-01"},"to":{"year":2026,"month":5,"price_zar":26.63,"effective_date":"2026-05-06"},"change_zar":10.47,"change_pct":64.79},"meta":{"cached":false}}
Comparar precios entre dos meses — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12771/fintech+personal+finance+fuel+pricing+api/24978/compare+prices+between+two+months?fuel_type=petrol_95®ion=inland&from=2020-01&to=2026-05' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud
Devuelve la próxima fecha esperada de anuncio de precios de combustible del DMRE y la cantidad de días restantes hasta esa fecha Los precios de combustible son anunciados por el DMRE el primer miércoles de cada mes Utiliza este endpoint para mostrar temporizadores de cuenta regresiva o para programar lógica de actualización en tu aplicación No se requieren parámetros
Endpoint ID: 24979
GET https://zylalabs.com/api/12771/fintech+personal+finance+fuel+pricing+api/24979/get+next+update+date
PARÁMETROS DE ENTRADA

Pruebas gratuitas restantes: 3 de 3.

Este endpoint no requiere parámetros de entrada.

RESPUESTA DE EJEMPLO DE LA API
JSON
{"success":true,"data":{"next_update":"2026-07-01","days_until":19},"meta":{"cached":false}}
Obtener fecha de próxima actualización — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12771/fintech+personal+finance+fuel+pricing+api/24979/get+next+update+date' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud
Devuelve el estado operativo actual de la API y una marca de tiempo del servidor Utiliza este endpoint para verificar que la API esté en línea antes de realizar otras solicitudes o para integrarlo en tu propio monitoreo de tiempo de actividad No se requieren parámetros Devuelve un estado 200 con ok cuando la API está operativa
Endpoint ID: 24980
GET https://zylalabs.com/api/12771/fintech+personal+finance+fuel+pricing+api/24980/health+check
PARÁMETROS DE ENTRADA

Pruebas gratuitas restantes: 3 de 3.

Este endpoint no requiere parámetros de entrada.

RESPUESTA DE EJEMPLO DE LA API
JSON
{"success":true,"data":{"status":"ok","timestamp":"2026-06-12T00:30:17.006Z"}}
Chequeo de salud — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12771/fintech+personal+finance+fuel+pricing+api/24980/health+check' --header 'Authorization: Bearer YOUR_API_KEY' 


    

Clave de Acceso a la API y Autenticación

Después de registrarte, a cada desarrollador se le asigna una clave de acceso a la API personal, una combinación única de letras y dígitos proporcionada para acceder a nuestro endpoint de la API. Para autenticarte con el Finanzas personales de fintech Precios de combustible API simplemente incluye tu token de portador en el encabezado de Autorización.

Encabezados
Encabezado Descripción
Autorización Requerido Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito.

Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.

(Ahorra 2 meses pagando anualmente 🎉)

🚀 PLAN CORPORATIVO A MEDIDA

Comienza en
$ 10.000/Año


  • Volumen Personalizado
  • Límite de solicitudes personalizado
  • Soporte al Cliente Especializado
  • Monitoreo de API en Tiempo Real

Resumen

Precios oficiales de bombas de combustible de Sudáfrica obtenidos del Departamento de Recursos Minerales y Petróleo (DMRE). Devuelve precios actuales e históricos para Gasolina 93 ULP, Gasolina 95 ULP y Diésel 50ppm tanto para regiones interiores como costeras. Datos históricos disponibles desde enero de 2008 hasta la fecha. Los precios se actualizan automáticamente cada miércoles a las 08:00 SAST

Finanzas personales de fintech Precios de combustible API FAQs

Los precios se actualizan cada miércoles a las 08:00 SAST. El DMRE anuncia nuevos precios de bomba el primer miércoles de cada mes. Si se produce un ajuste a mitad de mes debido a los movimientos del precio del petróleo o del tipo de cambio, se reflejará el miércoles siguiente

Los datos históricos están disponibles desde enero de 2008 hasta el presente más de 18 años de registros de precios de combustibles en Sudáfrica

Gasolina 93 ULP Gasolina 95 ULP y Diésel 50ppm tanto para regiones de interior como costeras Las columnas de queroseno iluminante existen en el esquema pero actualmente están vacías ya que los datos no están disponibles en la fuente

El DMRE establece diferentes precios de bombas para las regiones interiores y costeras debido a las diferencias en los costos de transporte y logística Los precios interiores (Gauteng y provincias circundantes) son típicamente un poco más altos que los precios costeros (Western Cape KwaZulu-Natal Eastern Cape)

Todos los precios se devuelven en ZAR (rand sudafricano) por litro

Faltan cinco meses en el conjunto de datos debido a lagunas en los datos fuente: julio de 2011 diciembre de 2014 febrero de 2015 julio de 2015 y septiembre de 2021 Solicitar estos meses a través de /month/:year/:month devolverá un 404

/último devuelve todos los tipos de combustible y ambas regiones en una sola respuesta anidada - útil cuando necesitas el tablero de precios completo /último/:tipo_de_combustible/:región devuelve un solo precio para un tipo de combustible y región específicos - útil cuando tu aplicación solo necesita un valor y quieres una respuesta más pequeña y rápida

Utiliza el punto final /compare. Pasa tu tipo de combustible, región, un mes de inicio y un mes de fin en formato AAAA-MM y la API devuelve el precio en ambos puntos más el cambio en ZAR y como un porcentaje. Ejemplo: /compare?fuel_type=petrol_95&region=inland&from=2020-01&to=2026-05

Todos los errores devuelven una forma JSON consistente: { "error": true, "code": "NO_ENCONTRADO", "message": "No se encontraron datos de precios de combustible para 2007-01" } Los códigos de error comunes son SOLICITUD_INCORRECTA (400) para parámetros inválidos y NO_ENCONTRADO (404) para meses sin datos

Cada punto final devuelve datos específicos de precios de combustible Por ejemplo el punto final /latest proporciona los precios actuales para todos los tipos de combustible y regiones mientras que /price-history devuelve precios históricos filtrados por tipo de combustible y región El punto final /compare muestra cambios de precios entre dos meses

Los campos clave incluyen "año" "mes" "precios" "tipo_de_combustible" "región" "precio_zar" "cambio_zar" y "cambio_pct" Estos campos proporcionan información esencial sobre los precios de los combustibles cambios a lo largo del tiempo y fechas efectivas

Los datos de respuesta están estructurados en formato JSON con una bandera de "éxito" un objeto "data" que contiene información de precios relevante y un objeto "meta" para detalles de origen y actualización Esta estructura permite un fácil análisis e integración en aplicaciones

Los parámetros varían según el punto final Por ejemplo /latest/:fuel_type/:region requiere "fuel_type" y "region" mientras que /price-history permite filtros opcionales para "fuel_type" y "region" Los usuarios pueden personalizar las solicitudes según sus necesidades específicas

Cada punto final proporciona información distinta: /latest da precios actuales /price-history ofrece datos históricos /trend muestra cambios de precios a lo largo de meses y /compare analiza diferencias de precios entre dos meses Esta variedad apoya diversas necesidades analíticas

Los usuarios pueden aprovechar los datos para el análisis de tendencias la elaboración de presupuestos y la planificación financiera Por ejemplo usar el endpoint /trend ayuda a visualizar las fluctuaciones de precios mientras que el endpoint /compare ayuda a comprender los cambios de costos a lo largo del tiempo mejorando la toma de decisiones

Los datos provienen del Departamento de Recursos Minerales y Petróleo (DMRE) de Sudáfrica. Esta fuente oficial garantiza la precisión y fiabilidad de la información sobre precios de combustibles proporcionada a través de la API

La precisión de los datos se mantiene a través de actualizaciones regulares del DMRE que anuncia nuevos precios mensualmente Además la API incluye un punto de control de salud para verificar el estado operativo asegurando que los usuarios reciban datos confiables

General FAQs

Zyla API Hub es como una gran tienda de APIs, donde puedes encontrar miles de ellas en un solo lugar. También ofrecemos soporte dedicado y monitoreo en tiempo real de todas las APIs. Una vez que te registres, puedes elegir qué APIs quieres usar. Solo recuerda que cada API necesita su propia suscripción. Pero si te suscribes a varias, usarás la misma clave para todas, lo que hace todo más fácil para ti.
Los precios se muestran en USD (dólar estadounidense), EUR (euro), CAD (dólar canadiense), AUD (dólar australiano) y GBP (libra esterlina). Aceptamos todas las principales tarjetas de débito y crédito. Nuestro sistema de pago utiliza la última tecnología de seguridad y está respaldado por Stripe, una de las compañías de pago más confiables del mundo. Si tienes algún problema para pagar con tarjeta, contáctanos en [email protected]

Además, si ya tienes una suscripción activa en cualquiera de estas monedas (USD, EUR, CAD, AUD, GBP), esa moneda se mantendrá para suscripciones posteriores. Puedes cambiar la moneda en cualquier momento siempre que no tengas suscripciones activas.
La moneda local que aparece en la página de precios se basa en el país de tu dirección IP y se proporciona solo como referencia. Los precios reales están en USD (dólar estadounidense). Cuando realices un pago, el cargo aparecerá en tu estado de cuenta en USD, incluso si ves el monto equivalente en tu moneda local en nuestro sitio web. Esto significa que no puedes pagar directamente en tu moneda local.
Ocasionalmente, un banco puede rechazar el cargo debido a sus configuraciones de protección contra fraude. Te sugerimos comunicarte con tu banco primero para verificar si están bloqueando nuestros cargos. También puedes acceder al Portal de Facturación y cambiar la tarjeta asociada para realizar el pago. Si esto no funciona y necesitas más ayuda, por favor contacta a nuestro equipo en [email protected]
Los precios se determinan mediante una suscripción recurrente mensual o anual, dependiendo del plan elegido.
Las llamadas a la API se descuentan de tu plan en base a solicitudes exitosas. Cada plan incluye una cantidad específica de llamadas que puedes realizar por mes. Solo las llamadas exitosas, indicadas por una respuesta con estado 200, se contarán en tu total. Esto asegura que las solicitudes fallidas o incompletas no afecten tu cuota mensual.
Zyla API Hub funciona con un sistema de suscripción mensual recurrente. Tu ciclo de facturación comenzará el día en que compres uno de los planes de pago, y se renovará el mismo día del mes siguiente. Así que recuerda cancelar tu suscripción antes si quieres evitar futuros cargos.
Para actualizar tu plan de suscripción actual, simplemente ve a la página de precios de la API y selecciona el plan al que deseas actualizarte. La actualización será instantánea, permitiéndote disfrutar inmediatamente de las funciones del nuevo plan. Ten en cuenta que las llamadas restantes de tu plan anterior no se transferirán al nuevo plan, por lo que debes considerar esto al actualizar. Se te cobrará el monto total del nuevo plan.
Para verificar cuántas llamadas a la API te quedan en el mes actual, revisa el campo 'X-Zyla-API-Calls-Monthly-Remaining' en el encabezado de la respuesta. Por ejemplo, si tu plan permite 1,000 solicitudes por mes y has usado 100, este campo mostrará 900 llamadas restantes.
Para ver el número máximo de solicitudes a la API que permite tu plan, revisa el encabezado de la respuesta 'X-Zyla-RateLimit-Limit'. Por ejemplo, si tu plan incluye 1,000 solicitudes por mes, este encabezado mostrará 1,000.
El encabezado 'X-Zyla-RateLimit-Reset' muestra el número de segundos hasta que tu límite se restablezca. Esto te indica cuándo tu conteo de solicitudes se reiniciará. Por ejemplo, si muestra 3,600, significa que faltan 3,600 segundos para que el límite se restablezca.
Sí, puedes cancelar tu plan en cualquier momento desde tu cuenta, seleccionando la opción de cancelación en la página de Facturación. Ten en cuenta que las actualizaciones, degradaciones y cancelaciones tienen efecto inmediato. Además, al cancelar ya no tendrás acceso al servicio, incluso si te quedaban llamadas en tu cuota.
Para darte la oportunidad de probar nuestras APIs sin compromiso, ofrecemos una prueba gratuita de 7 días que te permite realizar hasta 50 llamadas a la API sin costo. Esta prueba solo se puede usar una vez, por lo que recomendamos aplicarla a la API que más te interese. Aunque la mayoría de nuestras APIs ofrecen prueba gratuita, algunas pueden no hacerlo. La prueba finaliza después de 7 días o cuando realices 50 solicitudes, lo que ocurra primero. Si alcanzas el límite de 50 solicitudes durante la prueba, deberás "Iniciar tu Plan de Pago" para continuar haciendo solicitudes. Puedes encontrar el botón "Iniciar tu Plan de Pago" en tu perfil bajo Suscripción -> Elige la API a la que estás suscrito -> Pestaña de Precios. Alternativamente, si no cancelas tu suscripción antes del día 7, tu prueba gratuita finalizará y tu plan se cobrará automáticamente, otorgándote acceso a todas las llamadas a la API especificadas en tu plan. Ten esto en cuenta para evitar cargos no deseados.
Después de 7 días, se te cobrará el monto total del plan al que estabas suscrito durante la prueba. Por lo tanto, es importante cancelar antes de que finalice el periodo de prueba. No se aceptan solicitudes de reembolso por olvidar cancelar a tiempo.
Cuando te suscribes a una prueba gratuita de una API, puedes realizar hasta 50 llamadas. Si deseas realizar más llamadas después de este límite, la API te pedirá que "Inicies tu Plan de Pago". Puedes encontrar el botón "Iniciar tu Plan de Pago" en tu perfil bajo Suscripción -> Elige la API a la que estás suscrito -> Pestaña de Precios.
Las Órdenes de Pago se procesan entre el día 20 y el 30 de cada mes. Si envías tu solicitud antes del día 20, tu pago será procesado dentro de ese período.
Puedes contactarnos a través de nuestro canal de chat para recibir asistencia inmediata. Siempre estamos en línea de 8 a. m. a 5 p. m. (EST). Si nos contactas fuera de ese horario, te responderemos lo antes posible. Además, puedes escribirnos por correo electrónico a [email protected]

También te puede interesar