Skip to content
Updraft Docs
Türkçe

Layer parameters · API reference

Hourly sun position and forecast wind for the slope layers (pre-flight only).

GET /v1/slope-conditions

Sun position and forecast wind per hour for the slope layers (pre-flight only)

Authentication: X-Api-Key header; required scope: scope table.

Parameters

NameInTypeDescription
lat requiredquerynumberLatitude of the map view; snapped to its 0.25° cell
-90 ≤ x ≤ 90
lon requiredquerynumberLongitude of the map view; snapped to its 0.25° cell
-180 ≤ x ≤ 180
datequerystring (date) | nullLocal date (Europe/Istanbul), default today; the forecast covers today to today + 4 days, other dates give the sun only
example "2026-11-06"

Responses

StatusDescriptionContent
200Hours 05-21 of the local day; Cache-Control headerapplication/json → SlopeConditions
401code: auth_missing, auth_invalid, auth_revokedapplication/json → ErrorBody
403code: auth_scopeapplication/json → ErrorBody
422code: request_invalid, date_out_of_rangeapplication/json → ErrorBody
429code: rate_limited, quota_exceeded (Retry-After seconds)
Headers: Retry-After — Seconds until the exhausted window resets
application/json → ErrorBody