Documentation de l'API

L'API SkiesAtlas est une API REST simple. Chaque endpoint prend une latitude et une longitude et renvoie du JSON propre.

URL de base

https://skiesatlas.com/api/v1

Authentification

Passez votre clé API dans l'en-tête X-API-Key. Créez une clé depuis votre tableau de bord.

curl -H "X-API-Key: YOUR_KEY" \
  https://skiesatlas.com/api/v1/weather?lat=48.85&lon=2.35

Paramètres

`lat`	Latitude (-90 à 90)
`lon`	Longitude (-180 à 180)

Endpoints

GET/api/v1/weather

GET /api/v1/weather?lat=48.85&lon=2.35

Exemple de réponse

{"temperature_c":24.1,"feels_like_c":22.3,"humidity_pct":34,"pressure_hpa":1022.3,"wind_speed_kmh":5.9,"wind_direction_deg":52,"cloud_cover_pct":0,"condition":"clear","uv_index":2.7}

GET/api/v1/marine

GET /api/v1/marine?lat=43.66&lon=7.21

Exemple de réponse

{"wave_height_m":0.4,"wave_period_s":3.6,"wave_direction_deg":218,"swell_height_m":0.05,"wind_wave_height_m":0.4,"sea_state":"calm_rippled"}

GET/api/v1/rain

GET /api/v1/rain?lat=19.08&lon=72.88

Exemple de réponse

[{"until":"2026-08-12T12:00","precip_mm":2.1,"will_rain":true},{"until":"2026-08-12T15:00","precip_mm":0.6,"will_rain":true}]

GET/api/v1/air-quality

GET /api/v1/air-quality?lat=48.85&lon=2.35

Exemple de réponse

{"pm2p5":5.3,"pm10":9.9,"o3":73,"no2":10.5,"so2":1.2,"air_quality_index":2,"air_quality_label":"Fair"}

GET/api/v1/tides

GET /api/v1/tides?lat=san-francisco&lon=

Exemple de réponse

{"port":{"name":"San Francisco"},"extremes":[{"type":"High","height":1.6,"datetime":"2026-08-12T14:20"}]}

GET/api/v1/snow

GET /api/v1/snow?lat=45.9&lon=7.9

Exemple de réponse

{"temperature_c":-4.2,"snowfall_mm":3.1,"snow_depth_cm":180,"is_snowing":true,"freezing":true}

GET/api/v1/conditions

GET /api/v1/conditions?lat=43.66&lon=7.21

Exemple de réponse

{"weather":{...},"marine":{...},"rain_forecast":[...],"air_quality":{...}}