Créer vos identifiants API Météo France : données climatologiques

Étape 1 : Créer un compte sur le portail API Météo France

Accéder au portail

Toutes les ressources en Open Data de Météo France sont centralisées sur le portail officiel dédié aux développeurs : portail-api.meteofrance.fr.

Créer votre compte

1. Cliquez sur l’icône profil (avatar) située dans l’angle supérieur droit de l’interface.
2. Sur la page de connexion, sélectionnez l’option “Créer un compte”.
3. Renseignez votre Nom d’utilisateur. Cet identifiant sera requis pour chaque connexion. Conseil : Adoptez une nomenclature claire combinant le nom de votre projet et l’environnement cible (ex : MonApp.production).
4. Complétez le formulaire d’inscription avec les informations requises.
5. Validez votre inscription via l’e-mail de confirmation reçu.

L’accès est entièrement gratuit et débloque l’utilisation de l’ensemble du catalogue, notamment l’API Données Climatologiques.

---

Étape 2 : S’abonner à l’API Données Climatologiques

Trouver l’API dans le catalogue

1. Depuis la page d’accueil, utilisez la barre de recherche ou parcourez la liste pour trouver l’API Données Climatologiques.
2. Cliquez sur la fiche correspondante pour consulter les détails techniques.

Vous y trouverez la documentation des différents endpoints (liste-stations, commande-station, fichier) ainsi que les modalités de souscription.

Souscrire à l’API

1. Cliquez sur le bouton Souscrire à l’API gratuitement

L’abonnement active l’accès à l’ensemble des endpoints de l’API. La prise d’effet est immédiate.

---

Étape 3 : Générer la clé API

Configurer l’accès API

Sur le portail Météo France, chaque clé de sécurité est rattachée à une API spécifique.

1. Rendez-vous dans votre espace personnel via l’onglet MES API (menu utilisateur en haut à droite).
2. Repérez la ligne Données Climatologiques et cliquez sur Générer token.
3. Choisissez votre méthode d’authentification : OAuth2 ou API Key. Si vous optez pour “API Key”, précisez la durée de validité souhaitée (en secondes).
4. Confirmez en cliquant sur “Générer token”

Récupérer et sauvegarder le jeton

Dès la création, le portail génère votre clé API. Attention : Copiez-la immédiatement dans un coffre-fort numérique (gestionnaire de secrets).

Elle se présente sous la forme d’une chaîne de caractères alphanumérique :

a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4...

Copiez-le immédiatement dans un gestionnaire de secrets ou de mots de passe : pour des raisons de sécurité, cette clé ne sera plus consultable par la suite. En cas de perte, vous devrez générer un nouveau jeton (l’ancien restera actif sauf révocation manuelle).

---

Étape 4 : Sécuriser et transmettre la clé API

Stockage en variable d’environnement

La clé API ne doit jamais être écrite dans le code source ou versionnée dans git. Stockez-la en variable d’environnement dans votre logiciel :

# .env.local (ajouté dans .gitignore, jamais versionné)
METEOFRANCE_API_KEY=votre-cle-api-meteofrance

Utilisation dans le code Symfony :

public function __construct(
    #[Autowire(env: 'METEOFRANCE_API_KEY')] private string $apiKey,
) {}

Format du header d’authentification

L’API Météo France accepte deux modes d’authentification. Le plus simple pour un connecteur côté serveur est le header apikey :

curl -X GET "https://public-api.meteofrance.fr/public/DPClim/v1/liste-stations/infrahoraire-6m?id-departement=1" \
  -H "apikey: votre-cle-api-meteofrance" \
  -H "accept: application/json"

Le portail autorise également l’usage de jetons Bearer (OAuth2), recommandé pour les infrastructures gérant plusieurs clients.

Transmission à SmartBooster

Pour transmettre la clé API à l’équipe SmartBooster lors de l’intégration :

• Utiliser un gestionnaire de mots de passe partagé (Bitwarden, 1Password, Dashlane)
• Ne jamais envoyer par email, SMS ou messagerie en clair (Slack, Teams, WhatsApp)
• Créer une note sécurisée avec : la clé API, le nom de l’application sur le portail et l’environnement cible (développement, staging, production)

---

Vérifier l’accès

Avant de lancer les tests d’intégration, vérifiez que la clé fonctionne avec un appel simple sur l’endpoint de liste des stations quotidiennes :

curl -X GET \
  "https://public-api.meteofrance.fr/public/DPClim/v1/liste-stations/quotidienne?id-departement=75" \
  -H "apikey: VOTRE_CLE_API" \
  -H "accept: application/json"

La réponse doit retourner un tableau JSON de stations disponibles pour le département 75. Une erreur 401 indique que la clé est incorrecte ou que l’abonnement n’est pas actif.

---

Références

• Portail API Météo France
• Documentation API Données Climatologiques
• Licence OpenData Météo France