Documentação da API

Esta é uma documentação temporária e simples. Você encontrará os endpoints principais, exemplos de uso com fetch e iFrame, e uma resposta JSON de exemplo. Use sempre o domínio principal https://faltapoco.com para integrar a API.

Endpoints

GET /api/countdown/:slug

Retorna os dados da contagem regressiva para um slug (por exemplo: navidad).

GET /api/embed/:slug

Retorna HTML incorporável (widget) para integrar via iframe.

GET /api/pages

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

GET /api/health

Status do servidor (útil para health checks).

📦 Incorporação iFrame

Copie e cole este snippet para incorporar um contador em qualquer lugar.

<iframe src="https://faltapoco.com/api/embed/navidad" width="320" height="180" frameborder="0"></iframe>

Prévia:

Natal

32d 03h 55m 22s

Contador de exemplo incorporado

🔌 Fetch API

Obtenha os dados do contador em formato JSON para personalizá-lo.

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

Resposta JSON de exemplo:

{
  "slug": "navidad",
  "title": "Natal 2026",
  "targetIso": "2026-12-25T00:00:00Z",
  "days": 99
}

Notas rápidas e recomendações

Recomendamos usar o domínio principal https://faltapoco.com para todas as chamadas públicas à API.
Use cabeçalhos de cache (ex.: Cache-Control) ao integrar a API em ambientes com muita carga.
Se precisar redesenhar um contador no cliente, chame o endpoint periodicamente ou use o widget incorporado.

Testar Embed Testar Countdown Testar All Pages

Esta é uma documentação temporária. Em caso de dúvida ou falta de informação, fale conosco.