Vývojáři

Vítej v sekci pro vývojáře WeGlide.

Nabízíme tři odlišné služby, se kterými můžeš pracovat: Public API, OAuth a Maps.

API

Používání našeho API podporujeme. Rozhraní umožňuje čtenářský přístup ke všem datům veřejně dostupným na webu (např. lety, letadla, letiště, uživatelé, kluby).

Upozorňujeme, že API není finální. Plánujeme verzování API, abychom minimalizovali zásadní změny.

• Podmínky používání API
• Dokumentace Public API (Swagger)

API klíč

Individuální API klíč si můžeš vytvořit ve svém profilu v Profil → Nastavení → Pokročilé → API klíč. Současně můžeš mít maximálně 2 API klíče a požadavky jsou omezeny na 60 za den.

Svůj klíč posílej u každého požadavku v hlavičce X-API-Key.

Vyhrazujeme si právo vydávat API klíče pouze předplatitelům.

Search

Endpoint search umožňuje textové vyhledávání pro každý datový endpoint nazývaný „document". Lze předat více dokumentů oddělených čárkou takto: user,aircraft,airport.

Stažení vlastních IGC souborů

IGC soubor jednoho ze svých vlastních letů můžeš stáhnout pomocí svého API klíče. Nahraď ID letu svým a uveď svůj klíč. K přečtení odpovědi je potřeba jq.

KEY=wg_your_weglide_api_key
FLIGHT=123456

# Zjištění cesty k IGC souboru pro daný let
FILE=$(curl -s -H "X-API-Key: $KEY" "https://api.weglide.org/v1/flightdetail/$FLIGHT" | jq -r .igc_file.file)

# Stažení IGC souboru
curl -o "$FLIGHT.igc" "https://weglidefiles.b-cdn.net/$FILE"

Funguje to pouze pro tvé vlastní IGC soubory.

OAuth

Naše OAuth endpointy slouží k integraci služeb nebo hardwaru s WeGlide. To ti umožňuje interakci s WeGlide jménem jednotlivých uživatelů, jako je nahrávání letů nebo úprava úloh. Přístup k těmto funkcím udělují uživatelé pro jednotlivé účty prostřednictvím OAuth 2. Uživatel má možnost tato oprávnění kdykoli odvolat.

OAuth potřebuješ pouze v případě, že uživatelům své vlastní veřejné aplikace poskytuješ funkce WeGlide specifické pro účet, například letový počítač nebo meteorologickou službu, která jménem svých uživatelů nahrává nebo čte lety.

Kvůli nedávné vlně narychlo poskládaných (vibe coded) aplikací, které žádají o integraci s WeGlide, udělujeme klíče OAuth pouze aplikacím s alespoň 1000 uživateli. Upřednostňujeme důvěryhodné partnery s větší uživatelskou základnou, jako jsou LX a SkySight, kvůli manuální práci s nastavením a souvisejícímu supportu. Pokud si myslíš, že splňuješ podmínky, kontaktuj nás prosím s názvem své aplikace, společností a logem.

Nahrávání letů

Pokud tvá aplikace potřebuje pouze nahrávat lety, nepotřebuješ přístup k OAuth vůbec. Můžeš použít stejný endpoint pro nahrávání, jaký používá open source projekt XCSoar.

Mobilní loggery schvalujeme ručně a pouze pro soubory platné ve WeGlide (nejnižší úroveň zabezpečení). Vyžadují alespoň 500 uživatelů a schvalujeme je, jakmile zaznamenáme adopci v komunitě.

Maps

Naše mapy stavíme my s láskou a otevřenými daty.

Díky otevřeným standardům, jako jsou mapbox vector tiles a raster tiles, jsou kompatibilní s většinou moderního mapového softwaru.

Plánujeme zpřístupnit naše hostované mapy jako službu s férovým (řekněme levnějším než Mapbox/Maptiler atd.) účtováním. Kontaktuj nás prosím, abychom věděli, že je o ně zájem.