Atlas (API de données pays)

Atlas est une API et un tableau de bord de fiches pays : on choisit un pays et on obtient sa fiche d'identité et ses indicateurs économiques et sociaux, avec historique, comparaison, classement mondial et agrégats régionaux. Je l'ai construit seul entre fin juillet et fin septembre 2026 (environ 590 commits), et il est servi comme un produit, avec une interface et des messages d'erreur en quatre langues (français, anglais, espagnol, allemand).

Le problème

Les données par pays sont dispersées chez des fournisseurs qui ont chacun leur API, leurs codes, leurs unités et leur rythme de mise à jour. Un tableau de bord qui les mélange doit cacher tout cela.

Approche

Chaque fournisseur est un petit module adaptateur qui expose la même fonction, enregistré dans un registre de sources. Le catalogue compte 117 indicateurs curatés répartis en 11 thèmes, plus une longue traîne de 3 584 indicateurs cherchables mais jamais affichés par défaut. En production, l'API annonce 216 pays et 18 sources, dont la Banque mondiale, Our World in Data, Eurostat, l'OCDE, la BCE et le BLS. Ajouter un indicateur, c'est une ligne dans le catalogue. Ajouter une source, c'est un module.

Quelques décisions ont compté plus que le code :

Les agrégats sont recalculés. Les agrégats régionaux (UE, OCDE, G20...) sont recalculés à partir des pays membres.
Une capture est une preuve. Une « capture » fige une sélection et ses valeurs réelles sous un identifiant stable, puis expose le même objet en 12 formats.

Résultats et vérifications

À froid, un pays mal couvert pouvait dépasser 30 secondes au premier appel. Après le travail sur le cache et un script de préchauffage séparé, un appel à chaud mesurait environ 0,1 seconde sur le serveur de production. Des limites de débit par IP, des clés d'API par paliers et la facturation Stripe sont en place. J'ai aussi ajouté des données par subdivision (régions, états, comtés) pour certains pays, des routes hreflang par langue et une extension de navigateur.

Limites

Les tests tournent hors réseau et couvrent les règles d'agrégation, le refus d'inventer des valeurs et la cohérence du catalogue. Les routes elles-mêmes ne sont pas testées : je les vérifie à la main, et il n'y a pas de vérificateur de types. Les données de la Banque mondiale sont annuelles et peuvent avoir un à trois ans de retard, donc chaque valeur porte son année.

Suite

Du travail sur le SEO et l'acquisition, une extension powerpoint pour les graphiques, et de nouvelles sources, toujours plus de sources.