API - meteorologia.com.ar

Autenticación

Todas las solicitudes requieren una API key. Podes generarla gratis desde Mi cuenta.

Enviar la API key

Dos opciones:

Query parameter: ?key=TU_API_KEY
Header: X-API-Key: TU_API_KEY

# Ejemplo con query parameter
curl "https://meteorologia.com.ar/api/v1/current.php?key=TU_API_KEY&station=IITUZA12"

# Ejemplo con header
curl -H "X-API-Key: TU_API_KEY" "https://meteorologia.com.ar/api/v1/current.php?station=IITUZA12"

Datos actuales

GET /api/v1/current.php

Devuelve las condiciones actuales de una estación.

Parámetro	Tipo	Descripción
`key` requerido	string	Tu API key
`station` requerido	string	ID de la estación (ej: `IITUZA12`)

Respuesta

{
  "ok": true,
  "station": {
    "id": "IITUZA12",
    "name": "Parque Leloir",
    "location": "Ituzaingó, Buenos Aires",
    "lat": -34.624,
    "lon": -58.673,
    "elev": 27
  },
  "timestamp": "2026-03-01 14:30:00",
  "data": {
    "temp": 28.5,
    "feels_like": 30.2,
    "humidity": 62,
    "wind_speed": 12.5,
    "wind_dir": 180,
    "pressure": 1013.2,
    "precip_rate": 0,
    "precip_total": 2.4,
    "uv": 6,
    "solar_radiation": 542
  },
  "units": { "temp": "°C", "wind_speed": "km/h", ... }
}

Historial diario

GET /api/v1/history.php

Devuelve todas las lecturas de un día específico.

Parámetro	Tipo	Descripción
`key` requerido	string	Tu API key
`station` requerido	string	ID de la estación
`date`	string	Fecha en formato `YYYY-MM-DD` (default: hoy)

curl "https://meteorologia.com.ar/api/v1/history.php?key=TU_KEY&station=IITUZA12&date=2026-02-28"

Resumen

GET /api/v1/summary.php

Devuelve resúmenes diarios (máx/mín/promedio) para un período.

Parámetro	Tipo	Descripción
`key` requerido	string	Tu API key
`station` requerido	string	ID de la estación
`days`	int	Cantidad de días (1-90, default: 7)

curl "https://meteorologia.com.ar/api/v1/summary.php?key=TU_KEY&station=IITUZA12&days=30"

Listado de estaciones

GET /api/v1/stations.php

Lista todas las estaciones aprobadas de la red.

Parámetro	Tipo	Descripción
`key` requerido	string	Tu API key
`provincia`	string	Filtrar por provincia (ej: `Buenos Aires`)
`type`	string	Filtrar por tipo: `wu`, `direct`, `smn`

curl "https://meteorologia.com.ar/api/v1/stations.php?key=TU_KEY&provincia=Buenos%20Aires"

Widget embebible

Mostrá datos en tiempo real de cualquier estación en tu sitio web. No requiere API key.

Opción 1: Script (recomendada)

<script src="https://meteorologia.com.ar/js/widget.js"
        data-station="IITUZA12"
        data-theme="dark"></script>

Opción 2: iframe

<iframe src="https://meteorologia.com.ar/widget.php?station=IITUZA12&theme=dark"
        width="320" height="200" frameborder="0"
        style="border-radius:12px;"></iframe>

Parámetros

Parámetro	Valores	Default
`station` / `data-station`	ID de estación	—
`theme` / `data-theme`	`dark`, `light`	`dark`

Rate limits

1,000

Requests por día (plan gratuito)

Midnight ART

Reset diario (UTC-3)

Headers

X-RateLimit-Limit, Remaining, Reset

Cuando alcanzás el límite, la API responde 429 Too Many Requests con un header Retry-After indicando los segundos hasta el reset.

Códigos de error

HTTP	Código	Descripción
400	`missing_parameter`	Falta un parámetro requerido
400	`invalid_date`	Formato de fecha inválido
401	`missing_api_key`	No se proporcionó API key
401	`invalid_api_key`	API key no válida
403	`key_suspended`	API key suspendida o revocada
404	`station_not_found`	Estación no encontrada o no aprobada
404	`no_data`	Sin datos para la fecha solicitada
429	`rate_limit_exceeded`	Límite diario excedido
503	`no_data`	Datos temporalmente no disponibles

Todas las respuestas de error siguen el formato:

{
  "ok": false,
  "error": {
    "code": "error_code",
    "message": "Descripción del error"
  }
}

API Pública