Consultar precios de combustibles

const apiOrigin = '__API_ORIGIN__';
const params = new URLSearchParams({ fuel: 'gasoline-regular' });
const response = await fetch(`${apiOrigin}/v1/fuel-prices?${params}`);
if (!response.ok) throw new Error(`La consulta de combustible falló: ${response.status}`);
const { prices } = await response.json();
console.log(prices);

Una consulta válida sin precio para esa fecha devuelve HTTP 200 con prices: []. Un identificador de combustible desconocido devuelve 404. Si el precio vigente no está disponible temporalmente, la API devuelve 503.

Conserva amount como texto decimal hasta que tu aplicación defina cómo redondearlo o calcularlo. Las respuestas exitosas pueden guardarse en caché durante un máximo de 60 segundos, sin superar la vigencia del período actual. No guardes los errores en caché.

Cada precio explica qué representa el importe:

• amount es el precio publicado y currency es DOP.
• unit indica la medida de la fuente. Los combustibles líquidos usan US_GALLON; el gas natural puede usar CUBIC_METER o MMBTU.
• saleStage indica dónde aplica el precio, por ejemplo, venta minorista o de estación al público.
• effectiveFrom y effectiveTo son fechas de calendario inclusivas. El período aplica en ambas fechas.
• deliveryMode identifica el modo de entrega del gas natural (cng, lng o traditional-pipeline). No es otro identificador de combustible.
• sourceUrl enlaza la publicación o el archivo histórico correspondiente del MICM.

La API conserva la unidad y el importe publicados. No convierte metros cúbicos a MMBtu ni compara precios de distintas etapas de venta.

Para buscar el período que aplica en una fecha específica, usa effectiveOn:

curl '__API_ORIGIN__/v1/fuel-prices?fuel=gasoline-regular&effectiveOn=2024-07-01'
curl '__API_ORIGIN__/v1/fuel-prices?fuel=natural-gas&deliveryMode=cng'

Para consultar un rango de fechas, usa el endpoint de historial:

curl '__API_ORIGIN__/v1/fuel-prices/history?fuel=gasoline-regular&from=2024-01-01&to=2024-01-31&limit=100'

El historial devuelve períodos calificados que se superponen con el rango indicado. Si aparece nextCursor, repite los mismos filtros junto con ese cursor. Un intervalo vacío no demuestra que el precio se haya mantenido igual: el MICM publica resoluciones semanales y la API no inventa valores entre períodos publicados.