Guide de démarrage rapide : découvrir les APIs de Météo-France

Jan 21, 2026

Les APIs de Météo-France offrent un moyen simple d’accéder aux données météorologiques publiques (prévisions, observations, données expertisées, etc.) directement dans vos propres programmes.
L'objectif de cette page est de clarifier les concepts qui s’y rattachent pour mieux appréhender ces outils d’accès aux données publiques de Météo-France.

Le « portail des APIs » centralise toutes ces interfaces et permet de les tester en ligne, en mode découverte.

Sommaire

1 Qu’est-ce qu’une API et pourquoi l’utiliser ?
2 Créer et configurer votre compte
3 Abonnement à une API et gestion des accès
4 Comprendre et générer un token d’accès
5 Qu’est-ce qu’un endpoint ?
6 Déchiffrer et résoudre les éventuelles erreurs
7 Exemple concret : l’API Bulletin Vigilance de Météo-France
8 Exemple d’une requête API expliquée en détails
9 À retenir : les grandes lignes pour utiliser simplement une API
10 Liens et ressources utiles

Qu’est-ce qu’une API et pourquoi l’utiliser ?

Une API (Interface de Programmation Applicative) n’est rien d’autre qu’un ensemble de règles standardisées permettant à deux logiciels d’échanger des données. Par exemple, vous pouvez envoyer une requête web à une API météo et recevoir instantanément les prévisions ou les alertes sous forme de fichiers.

Nos APIs jouent le rôle de « pont » entre les serveurs météo et votre programme. Grâce à elles, vous obtenez automatiquement les données météorologiques actuelles sans avoir besoin d’aller chercher ces données manuellement. Cela vous fait gagner du temps et garantit l’actualité des données.

Créer et configurer votre compte

Pour utiliser ces APIs, commencez par créer un compte sur le portail des APIs Météo-France (un email valide et un mot de passe seront demandés).

Cliquer sur l’icône de connexion en haut à droite de la page d’accueil.

Pensez à choisir un nom d’usager clair (évitez les suites de caractères aléatoires) et à fournir une adresse e-mail correcte (pour recevoir les e-mails de confirmation ou de réinitialisation).

Prenez soin d’adopter les bonnes pratiques de sécurité : par exemple, utilisez un mot de passe long et complexe (minuscules/majuscules, chiffres, caractères spéciaux) pour qu’il soit difficile à deviner. Ne réutilisez pas ce mot de passe sur d’autres sites et songez à un gestionnaire de mots de passe si nécessaire.

Une fois votre compte créé et validé par e-mail, vous pourrez vous connecter au portail pour gérer vos APIs.

Menu de connexion. Permet également la création d’un nouveau compte ou la gestion de l’oubli de mot de passe.

Abonnement à une API et gestion des accès

Après connexion, la première étape est de s’abonner aux APIs qui vous intéressent. Pour cela, parcourez le catalogue et choisissez l’API sur laquelle vous souhaitez obtenir des données.

Vous arrivez ensuite sur la page d’accueil de l’API :

L’API Bulletin Vigilance permet de récupérer toutes les informations récentes de la Vigilance Météorologique.

Cliquez sur Souscrire à l’API gratuitement. Cela lie cette API à votre application et vous permet d’utiliser son service. L’abonnement est indispensable pour que votre application soit autorisée à interroger l’API.

Vous pouvez ensuite prendre connaissance du quota d’appels de l’API. Il s’agit de la limite maximale de requêtes que vous pourrez effectuer au cours d’une minute. Au-delà, l’API vous renverra une erreur HTTP 429 : "Too Many Requests". Par exemple, l’API Vigilance offre une limite d’environ 60 requêtes par minute.

Le tableau de bord du portail des APIs vous permet de visualiser toutes ces informations en un coup d’œil :

Vous pouvez consulter l'état de vos abonnements ainsi que les limites d’utilisation des APIs souscrites.

Comprendre et générer un token d’accès

Un token d’accès est une clé temporaire qui permet à un programme de prouver son identité lorsqu’il appelle une API.

Sans token valable, l’API refuse toute requête, même si vous êtes bien inscrit et abonné.

Le token n’est pas permanent.
Il a une durée de validité limitée (par exemple 1 heure).
Lorsqu’il expire, il faut en générer un nouveau.

Générer un token depuis le portail en mode découverte

Allez dans la page d’utilisation de l’API
Cliquez sur Generate Token
Le portail envoie une requête au serveur d’authentification pour prouver votre identité et le serveur vous renvoie un token temporaire qui devra ensuite être ajouté à chaque requête API.

Si le token est expiré ou incorrect, l’API renvoie une erreur 401 Unauthorized

Qu’est-ce qu’un endpoint ?

Dans le contexte d’une API, un endpoint est tout simplement une adresse précise qui permet d’accéder à une donnée ou à un service particulier.
Chaque endpoint correspond à une URL et à un type de requête. Par exemple, un endpoint peut servir à récupérer un bulletin de vigilance, une carte ou une image spécifique. Une API propose généralement plusieurs endpoints, chacun ayant un rôle bien défini.

Le mode découverte du portail permet de visualiser facilement ces différents services et de comprendre à quoi ils servent avant de les utiliser dans vos propres requêtes.

Certains endpoints acceptent des paramètres (par exemple un département, une date, un type de donnée) et permettent d’affiner la réponse de l’API.

🔗 Nous détaillerons plus en détails ces aspects par la suite.

Déchiffrer et résoudre les éventuelles erreurs

Lorsqu’une requête est envoyée à une API, le serveur renvoie toujours un code de statut.
Ce code permet de savoir rapidement si la requête a fonctionné ou, le cas échéant, pourquoi elle n’a pas abouti.

Un code d’erreur n’est pas un bug de votre application : c’est avant tout un message d’information normal qui fait partie intégrante du fonctionnement d’une API.

Le mode découverte est idéal pour identifier et diagnostiquer rapidement d'éventuels problèmes avant l'intégration de nos APIs dans vos propres programmes.

Codes les plus courants rencontrés :

Code	Signification	Explication

Code	Signification	Explication
202	Requête acceptée	La requête est valide et a été prise en compte
400	Erreur de paramètres	La requête est mal formée ou un paramètre est incorrect
401	Non autorisé	Le token est manquant, invalide ou expiré
403	Accès interdit	L’API n’est pas accessible (abonnement manquant, droits insuffisants)
404	Ressource inexistante	La donnée demandée n’existe pas
429	Trop de requêtes	Le nombre maximal d’appels autorisés est dépassé
500	Erreur serveur	Problème interne côté Météo-France
502	Erreur de passerelle	Problème temporaire entre serveurs
503	Service indisponible	Service momentanément indisponible
504	Délai dépassé	La réponse a pris trop de temps

Comment réagir en pratique ?

401 / 403 : vérifier le token et l’abonnement à l’API
400 / 404 : vérifier l’URL et les paramètres utilisés
429 : attendre avant de relancer des requêtes
500 à 504 : erreur temporaire : réessayer plus tard

Exemple concret : l’API Bulletin Vigilance de Météo-France

L’API Bulletin Vigilance fournit les niveaux de vigilance météorologique pour chaque département français. Elle propose de récupérer cette information sous forme de différents produits et formats.

Le mode découverte permet d’appréhender facilement les requêtes sur l’API en utilisant manuellement le portail des APIs.

Une fois connecté, abonné et après avoir généré un token valide, vous pouvez tester les différentes requêtes dans le mode découverte de l’API :

Je souhaite récupérer l’image PNG associée aux dernières informations de la Vigilance de Météo-France.

Pour cela, j'exécute la commande associée grâce au mode découverte de l’API.

La requête a réussi, je peux désormais récupérer l’image souhaitée.

Sur cet exemple, la requête est facile. En deux clics, il est possible de récupérer facilement le produit souhaité.
Mais elle permet de mieux appréhender les mécanismes de gestion des requêtes API en mode découverte.

A noter :

le code HTTP 200 renvoyé par l’API signifie que tout s’est bien passé et que le serveur a pu répondre favorablement à notre requête.
la requête cURL associée à notre demande se trouve tout en haut du panneau “Response” (cf. explications plus bas). L’icône du presse papier 📋️ permet de la copier en un clic. Vous pourrez ensuite la réutiliser facilement dans vos futurs scripts.

Exemple d’une requête API expliquée en détails

Voici la requête complète permettant de récupérer la vignette nationale de vigilance météo pour aujourd’hui (jour J) :

curl -X 'GET' \
'https://public-api.meteofrance.fr/public/DPVigilance/v1/vignettenationale-J/encours' \
-H 'accept: */*' \
-H 'Authorization: Bearer VOTRE_TOKEN'

cURL est un outil en ligne de commande qui permet d’envoyer des requêtes vers des serveurs web.
Il est souvent utilisé pour tester des APIs, car il est simple et disponible sur la plupart des systèmes (Linux, macOS, Windows).

-X ‘GET' signifie que l'on demande simplement à recevoir une information. C’est le type de requête le plus courant pour consulter une API.
L’URL qui suit se décompose ainsi :

https://public-api.meteofrance.fr/public/DPVigilance/v1/vignettenationale-J/encours

https://public-api.meteofrance.fr
→ le serveur de l’API Météo-France
/public/DPVigilance
→ l’API « Données Publiques de Vigilance »
/v1
→ version de l’API
/vignettenationale-J/encours
→ la ressource demandée : la vignette nationale de vigilance pour le jour en cours (J)

L’en-tête optionnel qui suit, -H ‘accept: /' , indique au serveur qu’il accepte n’importe quel type de réponse (une image PNG en l’occurrence dans notre exemple).

Puis, l’en-tête d’authentification, -H 'Authorization: Bearer VOTRE_TOKEN', permet de transmettre le token d’accès généré préalablement depuis le portail.

Le mode découverte du portail des APIs permet d’appréhender facilement le fonctionnement des requêtes, en les testant pas à pas directement depuis l’interface web, sans écrire de code. Une fois vos requêtes validées et comprises, il est alors possible d’automatiser vos flux de récupération de données en intégrant ces requêtes cURL dans vos propres scripts ou programmes.

Il est ainsi désormais à votre portée d’exploiter directement les données météorologiques de Météo-France au sein de vos applications, de manière autonome et sécurisée.

À retenir : les grandes lignes pour utiliser simplement une API

En résumé, les étapes indispensables à l’utilisation d’une API Météo-France sont :

Avoir un compte valide sur le portail des APIs de Météo-France.
S’abonner à l’API choisie (ici, l’API Bulletin Vigilance).
Vérifier le quota et conditions d’utilisation (ex. 60 req/min, accès gratuit avec compte).
Générer un jeton d’accès (token) à partir de la page d’utilisation de l’API.
Récupérer les données de l’API via des requêtes personnalisées.
Intégrer et automatiser ces requêtes dans vos propres programmes sur votre serveur informatique.

Liens et ressources utiles

La FAQ du portail des APIs décrit plus en détails les cas d’usages et les réponses aux questions les plus fréquentes.
La FAQ du portail documentaire de référence des données publiques répond à de nombreuses questions de nos usagers et propose des tutoriels d’accompagnement en vidéo.
L’ensemble des documentations techniques pour chaque API afin d’appréhender leur fonctionnement plus en profondeur.

Ces ressources vous permettront de compléter ce guide et de découvrir toutes les possibilités offertes par les APIs publiques de Météo-France. N’hésitez pas à parcourir la documentation en ligne pour approfondir chaque point.

Pour aller plus loin dans la programmation et l’intégration des services fournis par nos APIs au sein de vos scripts ou applications, nous vous invitons à approfondir vos connaissances en vous appuyant sur la documentation disponible et sur les nombreuses ressources accessibles en ligne.

🔗 À titre d’exemple, le guide publié sur data.gouv.fr présente de manière progressive les bases de l’analyse et du traitement de données avec Python, un langage couramment utilisé pour exploiter des APIs et automatiser des flux de données.