Documentazione API

L'API SkiesAtlas è una semplice API REST. Ogni endpoint riceve latitudine e longitudine e restituisce JSON pulito.

URL base

https://skiesatlas.com/api/v1

Autenticazione

Invia la tua chiave API nell'header X-API-Key. Crea una chiave dalla dashboard.

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

Parametri

`lat`	Latitudine (-90 a 90)
`lon`	Longitudine (-180 a 180)

Endpoint

GET/api/v1/weather

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

Esempio di risposta

{"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

Esempio di risposta

{"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

Esempio di risposta

[{"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

Esempio di risposta

{"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=

Esempio di risposta

{"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

Esempio di risposta

{"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

Esempio di risposta

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