Documentation de l'API

Ceci est une documentation temporaire et simple. Vous trouverez les endpoints principaux, des exemples d'utilisation avec fetch et iFrame, ainsi qu'une réponse JSON d'exemple. Utilisez toujours le domaine principal https://faltapoco.com pour intégrer l'API.

Points d'accès

GET /api/countdown/:slug

Renvoie les données du compte à rebours pour un slug (par exemple : navidad).

GET /api/embed/:slug

Renvoie du HTML intégrable (widget) à intégrer via iframe.

GET /api/pages

Liste basique des pages (slug, title, url).

GET /api/health

État du serveur (utile pour les health checks).

📦 Intégration iFrame

Copiez-collez cet extrait pour intégrer un compte à rebours n'importe où.

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

Aperçu :

Noël

32j 03h 55m 22s

Compte à rebours d'exemple intégré

🔌 Fetch API

Récupérez les données du compte à rebours au format JSON pour les personnaliser.

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

Exemple de réponse JSON :

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

Notes rapides et recommandations

Nous recommandons d'utiliser le domaine principal https://faltapoco.com pour tous les appels publics à l'API.
Utilisez des en-têtes de cache (ex. : Cache-Control) lorsque vous intégrez l'API dans des environnements à forte charge.
Si vous devez redessiner un compte à rebours côté client, appelez régulièrement l'endpoint ou utilisez le widget intégré.

Essayer Embed Essayer Countdown Essayer All Pages

Ceci est une documentation temporaire. En cas de doute ou d'information manquante, contactez-nous.