Pon FENIA en tu web o en tu sistema

Widgets

Elige qué mostrar, mira cómo queda y copia el código. Se actualiza solo cada 30 minutos, se adapta al ancho de tu página y no deja cookies.

API pública

Base: https://balexus.com/api/fenia/v1. Sólo lecturas, en JSON, y se puede llamar desde cualquier web (CORS abierto). La especificación completa está en OpenAPI 3.1: sirve para generar un cliente o probarla en Postman.

Un ejemplo

const r = await fetch('https://balexus.com/api/fenia/v1/distritos/200101?dias=3');
const piura = await r.json();

piura.aviso_senamhi.vigente   // ¿hay aviso de lluvia de SENAMHI hoy en su capital?
piura.aviso_senamhi.nivel     // 0 sin aviso; 1 a 4 según SENAMHI
piura.pronostico.dias         // [{ fecha, lluvia_mm, probabilidad_pct, sensacion_max_c, ... }]
piura.atribucion              // muéstralo junto a los datos
piura.aviso                   // y esto también
piura.plan.siguiente          // qué ganas si subes de plan

Tus sedes en una llamada

Con clave, POST /lote devuelve el aviso de SENAMHI y la lluvia de 7 días de cada distrito donde tienes un fundo, una tienda o un almacén, ordenados del que está peor al que está mejor.

curl -X POST https://balexus.com/api/fenia/v1/lote \
  -H "X-Api-Key: TU_CLAVE" -H "Content-Type: application/json" \
  -d '{"ubigeos": ["200101", "200105", "240101", "140101"]}'

Cómo responde

• Cada respuesta trae fuentes (quién publica cada dato y su enlace), atribucion y aviso.
• Si una fuente oficial no responde, el bloque dice disponible: false y el motivo. Nunca se rellena con una cifra inventada.
• El pronóstico trae origen: en_vivo (día por día) o panel (resumen de 7 días de la medición del mapa de FENIA, cuando hay mucha demanda).
• Los errores responden con un código estable: { ok: false, error: { codigo, mensaje } }.
• Dentro de la versión 1 sólo se agregan campos; nunca se renombran ni se quitan.
• Cada respuesta trae un bloque plan con lo que llevas usado hoy, y las cabeceras X-FENIA-Plan y X-FENIA-Cuota-Restante.
• Los topes dependen del plan. Guarda en caché lo que pidas: los datos cambian cada 30 minutos como mucho.

Planes de la API

Pruébala sin clave. Cuando la integres, pide tu clave gratis. Cuando la operación dependa de ella, FENIA Pro.

Pide tu clave gratis

Llega a tu correo en un minuto. Te pedimos quién eres y para qué la usarás: así sabemos a quién avisarle si la API cambia.

Condiciones de uso

• Uso gratuito en los planes Abierto y Gratis con clave, también en productos comerciales. Pro tiene condiciones propias.
• Muestra a la vista «Datos: FENIA · Balexus» con un enlace a balexus.com/fenia, y respeta la fuente que trae cada dato.
• No presentes los datos como un aviso oficial ni como una orden de evacuar: los avisos son de SENAMHI e INDECI.
• El pronóstico es de un modelo meteorológico global (Open-Meteo, licencia CC BY 4.0), no de SENAMHI; dilo igual que FENIA lo dice.
• Guarda en caché lo que pidas: los datos cambian cada 30 minutos como mucho. Los topes de pedidos dependen del plan.
• La clave es personal y se usa desde tu servidor. Una clave filtrada o usada para revender los datos se revoca.
• Sin garantía de disponibilidad. Si una fuente oficial no responde, la respuesta lo dice en vez de rellenar el hueco.

De quien integra FENIA sólo registramos el nombre del sitio donde está el widget o desde donde se llama a la API, para saber quién lo usa. Nada de las personas que lo miran.

¿Necesitas vigilar todas tus sedes, más volumen o soporte? Eso es FENIA Pro.