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.

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.

Upozorňujeme, že hobby projektům přístup k OAuth neudělujeme. Udělujeme jej pouze důvěryhodným partnerům 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.

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.