API météo : un flux de données parallèle

Récupérez prévisions et conditions extérieures en parallèle du JSON des sondes pour donner du contexte sur la page d’accueil ou dans vos CSV fusionnés.

Personne dans un froid extrême tenant un thermomètre extérieur qui affiche bien en dessous de zéro
Une vague de froid régionale peut dépasser ce que les applis météo laissent prévoir pour un garage attenant, un atelier ou un vide sanitaire. Photo : Bureau of Land Management: public domain

Les sondes du garage vous disent ce qui s’est passé à l’intérieur. Un appel parallèle à une API météo vous dit ce que l’atmosphère a apporté : utile pour rapprocher les infiltrations dues au vent, les minimales prévues et les jointures en tableur décrites dans graphiques en tableur. Cet appel ne doit pas bloquer le rendu SSR des sondes si le fournisseur météo est lent.

Flèches de requêtes parallèles du serveur vers le JSON des sondes et l’API météo, fusionnées au rendu SSR
Le serveur récupère en même temps les flux des sondes et l’API météo, pour que des prévisions lentes ne bloquent pas les températures en direct.

Stratégie de récupération

Utilisez Promise.allSettled ou un équivalent : un échec de récupération des sondes doit tout de même renvoyer la page en 200 avec une carte d’erreur ; un échec météo supprime simplement la prévision de la barre latérale. Les délais d’attente suivent les modèles de la récupération des sondes sur la page d’accueil.

Usage des données

  • Affichage uniquement : contexte de température/humidité extérieure sur le tableau de bord.
  • Enrichissement des CSV : jointure par tranche horaire lors de l’analyse des exports.
  • Pas pour le pilotage : ne déclenchez pas d’alerte de gel sur la seule base des prévisions.

Secrets et cache

Les clés d’API météo sont stockées dans les secrets Cloudflare. Mettez les réponses en cache plus longtemps que le TTL des sondes : la page sur la mise en cache des flux compare les besoins de fraîcheur.