{"openapi":"3.0.0","info":{"description":"API de contenu ; balise ts = http://api.previmeteo.net/doc/index.html","version":"1.5","title":"API Previmeteo","termsOfService":"http://swagger.io/terms/","contact":{"email":"support@previmeteo.com"}},"tags":[{"name":"meteo"},{"name":"geoname","description":"référence geoname","externalDocs":{"description":"Site geoname.org","url":"http://www.geonames.org"}},{"name":"fete","description":"fête du calendrier"},{"name":"soleil"},{"name":"lune"},{"name":"zodiac","description":"signe du zodiac"},{"name":"dicton","description":"dicton du jour"},{"name":"station-ski"},{"name":"commune","description":"commune (découpage administratif)"},{"name":"insee","description":"données INSEE"},{"name":"metar","description":"METeorological Aerodrome Report, données d'observations météo issues des aérodromes du monde entier"},{"name":"anmsm","description":"Association Nationale des Maires des Stations de Montagne. http://www.anmsm.fr."},{"name":"marée"}],"paths":{"/geoname/{geoname}":{"get":{"tags":["geoname"],"summary":"Détails pour un geoname donné","parameters":[{"name":"geoname","in":"path","description":"geoname","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"ok (5 résultats max)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Geoname"}}}},"404":{"description":"geoname inconnu"},"500":{"description":"erreur serveur"}},"security":[{"token":[]}]}},"/geoname/recherche/{recherche}":{"get":{"tags":["geoname"],"summary":"Recherche de villes par nom","parameters":[{"name":"recherche","in":"path","description":"recherche littérale","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeonameByName"}}}},"404":{"description":"aucune ville trouvée"},"500":{"description":"erreur serveur"}},"security":[{"token":[]}]}},"/{lat}/{lon}/geoname":{"get":{"tags":["geoname"],"summary":"geoname pour les coordonnées lat,lon demandées","parameters":[{"name":"lat","in":"path","required":true,"description":"latitude","schema":{"type":"number"}},{"name":"lon","in":"path","required":true,"description":"longitude","schema":{"type":"number"}}],"responses":{"200":{"description":"ok, liste de geoname","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/GeonameByName"}}}}}},"security":[{"token":[]}]}},"/meteo/texte/ts":{"get":{"tags":["meteo"],"summary":"Description textuelle d'un ou plusieurs code de temps sensible (max 3)","parameters":[{"name":"codes","in":"query","description":"codes de temps sensible (0 à 12) séparés par virgule","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"ok"},"400":{"description":"code invalide"},"500":{"description":"erreur serveur"}},"security":[{"token":[]}]}},"/meteo-ski/{station}":{"get":{"tags":["meteo","anmsm"],"summary":"Météo actuelle de la station de ski. Informations issues des stations membres de l'ANMSM.","parameters":[{"name":"station","in":"path","description":"identifiant de la station","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeteoAnmsm"}}}},"404":{"description":"aucune donnée"},"500":{"description":"erreur serveur"}},"security":[{"token":[]}]}},"/insee/communes/{code}":{"get":{"tags":["insee","commune"],"summary":"Informations sur la commune","parameters":[{"name":"code","in":"path","description":"code insee de la commune","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Commune"}}}},"404":{"description":"aucune commune avec ce code insee"},"500":{"description":"erreur serveur"}},"security":[{"token":[]}]}},"/insee/communes/cp/{code}":{"get":{"tags":["insee","commune"],"summary":"Liste des codes insee du code postal","parameters":[{"name":"code","in":"path","description":"code postal","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"array","items":{"type":"integer"}}}}},"404":{"description":"code postal inconnu"},"500":{"description":"erreur serveur"}},"security":[{"token":[]}]}},"/france/communes/{recherche}":{"get":{"tags":["commune"],"summary":"Recherche villes fr par nom","parameters":[{"name":"recherche","in":"path","description":"recherche littérale","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Commune"}}}},"404":{"description":"aucune commune trouvée"},"500":{"description":"erreur serveur"}},"security":[{"token":[]}]}},"/france/cp/{insee}":{"get":{"tags":["commune"],"summary":"Codes postaux rattachés au numéro insee","parameters":[{"name":"insee","in":"path","description":"numéro insee de la commune","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"array","items":{"type":"integer"}}}}},"404":{"description":"insee introuvable"},"500":{"description":"erreur serveur"}},"security":[{"token":[]}]}},"/{date}/fete/fr":{"get":{"tags":["fete"],"summary":"fête du jour","parameters":[{"name":"date","in":"path","description":"date au format YYYY-MM-DD","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fete"}}}},"400":{"description":"mauvais format de date"}},"security":[{"token":[]}]}},"/{lat}/{lon}/{date}/soleil":{"get":{"tags":["soleil"],"summary":"heures de lever / coucher soleil","parameters":[{"name":"lat","in":"path","required":true,"description":"latitude","schema":{"type":"number"}},{"name":"lon","in":"path","required":true,"description":"longitude","schema":{"type":"number"}},{"name":"date","in":"path","description":"date au format YYYY-MM-JJ","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Soleil"}}}}},"security":[{"token":[]}]}},"/{date}/lune":{"get":{"tags":["lune"],"summary":"jour lunaire","parameters":[{"name":"date","in":"path","required":true,"description":"date au format YYYY-MM-JJ","schema":{"type":"string"}}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"integer"}}}}},"security":[{"token":[]}]}},"/{date}/zodiac":{"get":{"tags":["zodiac"],"summary":"signe astrologique du jour (mois en cours)","parameters":[{"name":"date","in":"path","required":true,"description":"date au format YYYY-MM-JJ","schema":{"type":"string"}}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Zodiac"}}}}},"security":[{"token":[]}]}},"/{date}/maree":{"get":{"tags":["maree"],"summary":"coefficient de marée du jour","parameters":[{"name":"date","in":"path","required":true,"description":"date au format YYYY-MM-JJ","schema":{"type":"string"}}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CoefsMaree"}}}}}},"security":[{"token":[]}]}},"/{date}/dicton":{"get":{"tags":["dicton"],"summary":"dicton du jour","parameters":[{"name":"date","in":"path","required":true,"description":"date au format YYYY-MM-JJ","schema":{"type":"string"}}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"string"}}}}},"security":[{"token":[]}]}},"/{lat}/{lon}/meteo":{"get":{"tags":["meteo"],"summary":"météo pour les coordonnées lat,lon demandées","parameters":[{"name":"lat","in":"path","required":true,"description":"latitude","schema":{"type":"number"}},{"name":"lon","in":"path","required":true,"description":"longitude","schema":{"type":"number"}},{"name":"jplus","in":"query","required":false,"description":"nombre de jours souhaité après le jour actuel, maximum 6","schema":{"type":"number"}}],"responses":{"200":{"description":"ok, liste de prévisions indexée par date au format YYYY-MM-DD","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Prevision"}}}}}},"security":[{"token":[]}]}},"/{lat}/{lon}/meteo/24h":{"get":{"tags":["meteo"],"summary":"météo pour les coordonnées lat,lon demandées au pas de 24h","parameters":[{"name":"lat","in":"path","required":true,"description":"latitude","schema":{"type":"number"}},{"name":"lon","in":"path","required":true,"description":"longitude","schema":{"type":"number"}},{"name":"jplus","in":"query","required":false,"description":"nombre de jours souhaité après le jour actuel, maximum 6","schema":{"type":"number"}}],"responses":{"200":{"description":"ok, liste de prévisions indexée par date au format YYYY-MM-DD","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Prevision24"}}}}}},"security":[{"token":[]}]}},"/{lat}/{lon}/meteo/6h":{"get":{"tags":["meteo"],"summary":"météo pour les coordonnées lat,lon demandées pas de 6h","parameters":[{"name":"lat","in":"path","required":true,"description":"latitude","schema":{"type":"number"}},{"name":"lon","in":"path","required":true,"description":"longitude","schema":{"type":"number"}},{"name":"jplus","in":"query","required":false,"description":"nombre de jours souhaité après le jour actuel, maximum 6","schema":{"type":"number"}}],"responses":{"200":{"description":"ok, liste de prévisions indexée par date au format YYYY-MM-DD","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Prevision"}}}}}},"security":[{"token":[]}]}},"/{lat}/{lon}/meteo/3h":{"get":{"tags":["meteo"],"summary":"météo pour les coordonnées lat,lon demandées pas de 3h","parameters":[{"name":"lat","in":"path","required":true,"description":"latitude","schema":{"type":"number"}},{"name":"lon","in":"path","required":true,"description":"longitude","schema":{"type":"number"}},{"name":"jplus","in":"query","required":false,"description":"nombre de jours souhaité après le jour actuel, maximum 6","schema":{"type":"number"}}],"responses":{"200":{"description":"ok, liste de prévisions indexée par date au format YYYY-MM-DD","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Prevision"}}}}}},"security":[{"token":[]}]}},"/{lat}/{lon}/meteo/1h":{"get":{"tags":["meteo"],"summary":"météo pour les coordonnées lat,lon demandées pas de 1h","parameters":[{"name":"lat","in":"path","required":true,"description":"latitude","schema":{"type":"number"}},{"name":"lon","in":"path","required":true,"description":"longitude","schema":{"type":"number"}},{"name":"jplus","in":"query","required":false,"description":"nombre de jours souhaité après le jour actuel, maximum 6","schema":{"type":"number"}}],"responses":{"200":{"description":"ok, liste de prévisions indexée par date au format YYYY-MM-DD","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Prevision"}}}}}},"security":[{"token":[]}]}},"/{lat}/{lon}/plage":{"get":{"tags":["meteo"],"summary":"météo des plages pour les coordonnées lat,lon demandées","parameters":[{"name":"lat","in":"path","required":true,"description":"latitude","schema":{"type":"number"}},{"name":"lon","in":"path","required":true,"description":"longitude","schema":{"type":"number"}}],"responses":{"200":{"description":"ok, liste de prévisions de la plage la plus près indexée par date au format YYYY-MM-DD (état de la mer : https://fr.wikipedia.org/wiki/État_de_la_mer)","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Plage"}}}}}},"security":[{"token":[]}]}},"/{geoname}/meteo":{"get":{"tags":["meteo"],"summary":"météo pour le geoname demandé","parameters":[{"name":"geoname","in":"path","required":true,"description":"référence geoname","schema":{"type":"number"}},{"name":"jplus","in":"query","required":false,"description":"nombre de jours souhaité après le jour actuel, maximum 6","schema":{"type":"number"}}],"responses":{"200":{"description":"ok, liste de prévisions indexée par date au format YYYY-MM-DD","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Prevision"}}}}}},"security":[{"token":[]}]}},"/{lat}/{lon}/stations-ski":{"get":{"tags":["station-ski"],"summary":"stations de ski les plus proches","parameters":[{"name":"lat","in":"path","required":true,"description":"latitude","schema":{"type":"number"}},{"name":"lon","in":"path","required":true,"description":"longitude","schema":{"type":"number"}}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NearestStations"}}}}}}}},"/{lat}/{lon}/oaci":{"get":{"tags":["metar"],"summary":"aéroports les plus proches","parameters":[{"name":"lat","in":"path","required":true,"description":"latitude","schema":{"type":"number"}},{"name":"lon","in":"path","required":true,"description":"longitude","schema":{"type":"number"}}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NearestMetar"}}}}}}}},"/{lat}/{lon}/france/communes":{"get":{"tags":["commune"],"summary":"communes les plus proches","parameters":[{"name":"lat","in":"path","required":true,"description":"latitude","schema":{"type":"number"}},{"name":"lon","in":"path","required":true,"description":"longitude","schema":{"type":"number"}}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Commune"}}}}}}}},"/stations-meteo/metar/{oaci}":{"get":{"tags":["metar"],"summary":"dernier rapport METAR de la station","parameters":[{"name":"oaci","in":"path","required":true,"description":"code OACI","schema":{"type":"string"}}],"responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeonameByName"}}}}}}}},"servers":[{"url":"https://api.previmeteo.net"}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"Prevision":{"type":"object","properties":{"ts":{"type":"string","format":"float","description":"identifiant temps sensible"},"t_min":{"type":"number","format":"float","description":"température minimale en °C"},"t_max":{"type":"number","format":"float","description":"température maximale en °C"},"vent":{"type":"number","format":"float","description":"vitesse moyenne du vent en km/h"},"dir":{"type":"number","description":"direction du vent en degré"},"raf":{"type":"number","description":"rafale de vent en km/h"},"rh":{"type":"number","description":"humidité relative en %"},"pluie":{"type":"number","format":"float","description":"mm de pluie"},"pres":{"type":"number","format":"integer","description":"pression hPa"}}},"Prevision24":{"type":"object","properties":{"ts":{"type":"string","format":"float","description":"identifiant temps sensible"},"t_min":{"type":"number","format":"float","description":"température minimale en °C"},"t_max":{"type":"number","format":"float","description":"température maximale en °C"},"vent":{"type":"number","format":"float","description":"vitesse moyenne du vent en km/h"},"dir":{"type":"number","description":"direction du vent en degré"},"raf":{"type":"number","description":"rafale de vent en km/h"},"rh":{"type":"number","description":"humidité relative en %"},"pluie":{"type":"number","format":"float","description":"mm de pluie"},"pres":{"type":"number","format":"integer","description":"pression hPa"},"dju18":{"type":"number","format":"integer","description":"dju base 18 dans meteo 24h seulement"}}},"Plage":{"type":"object","properties":{"infos":{"type":"object","properties":{"id":{"type":"integer","format":"int32"},"name":{"type":"string"},"lon":{"type":"number"},"lat":{"type":"number"}}},"prev":{"type":"object","properties":{"date":{"type":"object","properties":{"lever":{"type":"string"},"coucher":{"type":"string"},"fete":{"type":"string"},"uv":{"type":"integer"},"maree":{"type":"object","properties":{"basse_mer":{"type":"object","properties":{"matin":{"type":"object","properties":{"heure":{"type":"string"},"coef":{"type":"integer","format":"int32"}}},"apresmidi":{"type":"object","properties":{"heure":{"type":"string"},"coef":{"type":"integer","format":"int32"}}}}},"haute_mer":{"type":"object","properties":{"matin":{"type":"object","properties":{"heure":{"type":"string"},"coef":{"type":"integer","format":"int32"}}},"apresmidi":{"type":"object","properties":{"heure":{"type":"string"},"coef":{"type":"integer","format":"int32"}}}}}}},"meteo":{"type":"object","properties":{"mat":{"type":"object","properties":{"ts":{"type":"integer"},"tair":{"type":"number"},"vent":{"type":"number"},"dir":{"type":"string"},"raf":{"type":"number"},"teau":{"type":"number","format":"int32"},"hauthoule":{"type":"number"},"etatmer":{"type":"integer"},"texte_meteo":{"type":"string"}}},"apm":{"type":"object","properties":{"ts":{"type":"integer"},"tair":{"type":"number"},"vent":{"type":"number"},"dir":{"type":"string"},"raf":{"type":"number"},"teau":{"type":"integer","format":"int32"},"hauthoule":{"type":"number"},"etatmer":{"type":"integer"},"texte_meteo":{"type":"string"}}},"soir":{"type":"object","properties":{"ts":{"type":"number"},"tair":{"type":"number"},"vent":{"type":"number"},"dir":{"type":"string"},"raf":{"type":"number"},"teau":{"type":"integer","format":"int32"},"hauthoule":{"type":"number"},"etatmer":{"type":"integer"},"texte_meteo":{"type":"string"}}}}}}}}}}},"Geoname":{"type":"object","properties":{"nom":{"type":"string"},"population":{"type":"integer","format":"int64"},"fuseau":{"type":"string"},"lat":{"type":"number","format":"float"},"lon":{"type":"number","format":"float"}}},"GeonameByName":{"type":"object","properties":{"geoname":{"type":"integer","format":"int64"},"nom":{"type":"string"},"population":{"type":"integer","format":"int64"},"lat":{"type":"number","format":"float"},"lon":{"type":"number","format":"float"},"admin1":{"type":"string"},"admin2":{"type":"string"}}},"MeteoAnmsm":{"type":"object","properties":{"dtMajStation":{"type":"string","format":"date"},"dtChute":{"type":"string","format":"date","description":"date de la dernière chute de neige"},"tsj0":{"type":"string","description":"description textuelle du temps sensible jour en cours"},"tsj1":{"type":"string","description":"description textuelle du temps sensible prévu pour le lendemain"},"neigeBasCm":{"type":"integer","format":"int32"},"neigeHautCm":{"type":"integer","format":"int32"},"qualNeige":{"type":"string","description":"description textuelle de la qualité de la neige"},"retStationASki":{"type":"string","description":"possible, partiellement possible ou impossible"},"pourcentageOuverture":{"type":"integer","format":"int32"}}},"Commune":{"type":"object","properties":{"insee":{"type":"integer","format":"int32"},"cp":{"type":"integer","format":"int32"},"nom":{"type":"string"},"population":{"type":"number","format":"float","description":"population, en millier"},"altitude":{"type":"integer","format":"int32"},"latitude":{"type":"number","format":"float"},"longitude":{"type":"number","format":"float"},"codeDpt":{"type":"integer","format":"int32"},"surface":{"type":"number","format":"float","description":"surface en 1/10 de km2"}}},"Fete":{"type":"object","properties":{"long":{"type":"string","description":"format long (précédé de Saint, Sainte)"},"short":{"type":"string","description":"format court"}}},"Soleil":{"type":"object","properties":{"lever":{"type":"string","description":"au format HH:MM"},"coucher":{"type":"string","description":"au format HH:MM"}}},"Zodiac":{"type":"object","properties":{"nom":{"type":"string","description":"nom du signe"},"codeUtf8":{"type":"string","description":"code utf8 du signe"},"element":{"type":"string","description":"élément associé (air, terre, eau, feu)"},"jour":{"type":"integer","description":"jour du signe"}}},"CoefsMaree":{"type":"object","description":"nom de l'objet = date au format YYYY-MM-DD","properties":{"am":{"type":"integer","description":"nom du signe"},"pm":{"type":"integer","description":"code utf8 du signe"}}},"NearestStations":{"type":"object","properties":{"id":{"type":"integer","description":"identifiant anmsm de la station"},"nom":{"type":"string","description":"nom de la station"},"massif":{"type":"string","description":"massif montageux de la station"},"latitude":{"type":"number","format":"float"},"longitude":{"type":"number","format":"float"},"distance":{"type":"number","description":"distance au point"}}},"NearestMetar":{"type":"object","properties":{"icao":{"type":"string","description":"identifiant icao"},"synop":{"type":"number","description":"identifiant synop"},"latitude":{"type":"number","format":"float"},"longitude":{"type":"number","format":"float"},"elev":{"type":"integer","description":"altitude de la station"},"distance":{"type":"number","description":"distance au point"}}}}}}