Sürüm notları

Sürüm kuralları

API sürümü yoldadır (/v1). Kırıcı değişiklik /v2 ister; /v1 bu sırada çalışmaya devam eder.
Kırıcı olmayan değişiklikler: yeni uç, yeni isteğe bağlı parametre, yanıta yeni alan, yeni hata kodu. İstemciniz bilmediği alanları ve kodları yok saymalıdır.
Hata code değerlerinin, kademeli sayı basamaklarının (min_pilots) ve termik parametrelerinin anlamı sürüm içinde değişmez.
Karo kaynaklarının kalıcı adları (base, contours, thermals …) değişmez; derleme içerikleri yenilenir.
OpenAPI dosyası her zaman güncel: openapi.json; sitenin altbilgisi hangi sürümden üretildiğini gösterir.

@updraft/maps (npm) ve updraft_maps (pub.dev): anahtar başlığı, hata gövdesi, karo ve stil adresleri, OpenAPI'den üretilmiş tipler, MapLibre GL JS, flutter_map ve maplibre_gl yardımcıları; hızlı başlangıçlar bu paketleri kullanır (Kimlik). Paket sürümü API sürümüyle aynıdır.

API anahtarı, kapsam, oran sınırı ve kullanım sayaçları: anahtar başına dakika, gün ve ay sınırı; 429 rate_limited / quota_exceeded, Retry-After, X-RateLimit-Limit, X-RateLimit-Window (Oran sınırı).
Anahtarlı karo yolu: X-Api-Key başlıklı karo istekleri tiles kapsamıyla denetlenir ve sayılır; anahtarsız yol istemci adresi başına sınırlı kalır (Karolar ve stiller).
İlk yıl ücretsiz: plan, fatura ve ödeme yok; atıf zorunlu (Atıf).
Belge sitesi: hızlı başlangıçlar (MapLibre GL JS, flutter_map, maplibre_gl), canlı örnek, OpenAPI'den üretilen referans.

GET /v1/sites: onaylı kalkış ve iniş noktaları (GeoJSON, imleçli sayfalama, ETag).
POST /v1/flights: IGC yükleme (sunucudan sunucuya, rıza sürümüyle).
GET /v1/packs/{region}: internetsiz bölge paketleri (PMTiles).
GET /v1/regions ve GET /v1/regions/{region}/profile: uçuş bölgeleri ve bölge profili.
POST /v1/consents/withdrawals, POST /v1/consents/grants: katkı rızasının geri çekilmesi ve yeniden verilmesi.
POST /v1/flights/{flight_id}/shares, GET /v1/replay/{public_id}: uçuş paylaşımı ve herkese açık tekrar.
Karo: pilot gözü stili (açık, koyu), termik ızgarası (thermals, ay/saat/rüzgâr), skyway, elektrik hatları, raster PNG (z5–16).