Kalkış ve iniş · API referansı
Onaylı kalkış ve iniş noktaları, GeoJSON.
GET /v1/sites
Approved takeoff and landing sites in a bounding box
Kimlik: X-Api-Key başlığı; gereken kapsam: kapsam tablosu.
Parametreler
| Ad | Yer | Tip | Açıklama |
|---|---|---|---|
bbox zorunlu | sorgu | string | west,south,east,north in degrees (WGS 84); each side at most 20°, west < east (no antimeridian wrap)0–200 chars · örnek "28.5,36.0,30.0,37.2" |
kind | sorgu | "takeoff" | "landing" | null | Only this kind; both when omitted |
limit | sorgu | integer | Sites per page1 ≤ x ≤ 500 · varsayılan 100 |
cursor | sorgu | string | null | next_cursor of the previous page0–64 chars |
Yanıtlar
| Durum | Açıklama | İçerik |
|---|---|---|
200 | GeoJSON FeatureCollection, ordered by id; ETag and Cache-Control headers | application/geo+json → SiteCollection |
304 | If-None-Match matched the current ETag; no body | |
401 | code: auth_missing, auth_invalid, auth_revoked | application/geo+json → ErrorBody |
403 | code: auth_scope | application/geo+json → ErrorBody |
422 | code: request_invalid, bbox_invalid, bbox_too_large, cursor_invalid | application/geo+json → ErrorBody |
429 | code: rate_limited, quota_exceeded (Retry-After seconds)Başlıklar: Retry-After — Seconds until the exhausted window resets | application/json → ErrorBody |
GET /v1/sites/{site_id}/suitability
Take-off suitability for a day from the wind forecast (pre-flight planning only)
Kimlik: X-Api-Key başlığı; gereken kapsam: kapsam tablosu.
Parametreler
| Ad | Yer | Tip | Açıklama |
|---|---|---|---|
site_id zorunlu | yol | string (uuid) | Take-off id (GET /v1/sites) |
date | sorgu | string (date) | null | Local date (Europe/Istanbul), today to today + 4 days; default today örnek "2026-11-06" |
Yanıtlar
| Durum | Açıklama | İçerik |
|---|---|---|
200 | Slots of the local day; Cache-Control header | application/json → SuitabilityResponse |
401 | code: auth_missing, auth_invalid, auth_revoked | application/json → ErrorBody |
403 | code: auth_scope | application/json → ErrorBody |
404 | code: site_not_found | application/json → ErrorBody |
422 | code: request_invalid, date_out_of_range | application/json → ErrorBody |
429 | code: rate_limited, quota_exceeded (Retry-After seconds)Başlıklar: Retry-After — Seconds until the exhausted window resets | application/json → ErrorBody |