Documentación de la API

Esta es una documentación temporal y simple. Encontrarás los endpoints principales, ejemplos de uso con fetch y iFrame, y una respuesta JSON de ejemplo. Usá siempre el dominio principal https://faltapoco.com para integrar la API.

Endpoints

GET /api/countdown/:slug

Devuelve los datos del contador para un slug (por ejemplo: navidad).

GET /api/embed/:slug

Devuelve HTML embebible (widget) para integrar vía iframe.

GET /api/pages

Lista básica de páginas (slug, title, url).

GET /api/health

Estado del servidor (util para health checks).

POST /api/reload-cache

Forza la recarga del cache de páginas en el servidor (administración).

📦 iFrame embed

Copia y pega este snippet para embeber un contador en cualquier sitio.

<iframe src="https://faltapoco.com/api/embed/navidad" width="100%" height="250" frameborder="0" style="border-radius:8px;"></iframe>

Preview:

Navidad

32d 03h 55m 22s

Contador de ejemplo embebido

🔌 Fetch usage

Consumir la API (ejemplo con fetch):

fetch("https://faltapoco.com/api/countdown/navidad")
    .then(res => res.json())
    .then(data => console.log(data));

JSON response preview:

{
    "slug": "navidad",
    "title": "Navidad",
    "targetDate": "2025-12-25T00:00:00Z",
    "timeLeft": { "days": 32, "hours": 3, "minutes": 55, "seconds": 22 }
}

Notas rápidas y recomendaciones

Recomendamos usar el dominio principal https://faltapoco.com para todas las llamadas públicas a la API.
Usá cabeceras de cache (ej.: Cache-Control) cuando integres la API en entornos con mucha carga.
Si necesitás re-dibujar un contador en el cliente, llamá periódicamente al endpoint o usá el widget embebido.

Probar Embed Probar Countdown Probar All Pages

Esta es una documentación temporal. En caso de duda o falta de información, contactanos.