Deweloperzy

Witaj w sekcji dla deweloperów WeGlide.

Oferujemy trzy odrębne usługi do pracy: Public API, OAuth oraz Maps.

API

Zachęcamy do korzystania z naszego API. Interfejs umożliwia odczyt wszystkich danych publicznie dostępnych na stronie (np. lotów, samolotów, lotnisk, użytkowników, klubów).

Pamiętaj, że API nie jest jeszcze finalne. Planujemy wersjonowanie API, aby zminimalizować zmiany łamiące kompatybilność.

• Warunki korzystania z API
• Dokumentacja Public API (Swagger)

Klucz API

Indywidualny klucz API możesz utworzyć w swoim profilu w Profil → Ustawienia → Zaawansowane → Klucz API. Jednocześnie możesz mieć maksymalnie 2 klucze API, a liczba żądań jest ograniczona do 60 dziennie.

Swój klucz wysyłaj w nagłówku X-API-Key przy każdym żądaniu.

Zastrzegamy sobie prawo do wydawania kluczy API wyłącznie subskrybentom.

Search

Endpoint wyszukiwania umożliwia wyszukiwanie tekstowe dla każdego endpointu danych zwanego "document". Można przekazać wiele dokumentów rozdzielonych przecinkiem w ten sposób: user,aircraft,airport.

Pobieranie własnych plików IGC

Plik IGC jednego z własnych lotów możesz pobrać za pomocą swojego klucza API. Zastąp identyfikator lotu swoim i podaj swój klucz. Do odczytania odpowiedzi wymagany jest jq.

KEY=wg_your_weglide_api_key
FLIGHT=123456

# Ustal ścieżkę pliku IGC dla lotu
FILE=$(curl -s -H "X-API-Key: $KEY" "https://api.weglide.org/v1/flightdetail/$FLIGHT" | jq -r .igc_file.file)

# Pobierz plik IGC
curl -o "$FLIGHT.igc" "https://weglidefiles.b-cdn.net/$FILE"

Działa to tylko dla twoich własnych plików IGC.

OAuth

Nasze endpointy OAuth służą do integracji usług lub sprzętu z WeGlide. Pozwala to na interakcję z WeGlide w imieniu poszczególnych użytkowników, taką jak wgrywanie lotów lub edytowanie zadań. Dostęp do tych funkcji jest przyznawany przez użytkowników w odniesieniu do konkretnego konta za pośrednictwem OAuth 2. Użytkownik ma możliwość cofnięcia tych uprawnień w dowolnym momencie.

OAuth potrzebujesz tylko wtedy, gdy udostępniasz użytkownikom swojej własnej publicznie dostępnej aplikacji funkcje WeGlide związane z konkretnym kontem, na przykład komputer pokładowy lub serwis pogodowy, który w imieniu swoich użytkowników wgrywa lub odczytuje loty.

Ze względu na niedawną falę naprędce sklecanych (vibe coded) aplikacji, które proszą o integrację z WeGlide, przyznajemy klucze OAuth wyłącznie aplikacjom z co najmniej 1000 użytkowników. Priorytetowo traktujemy zaufanych partnerów z większą bazą użytkowników, takich jak LX i SkySight, ze względu na nakład pracy przy ręcznej konfiguracji oraz związane z tym wsparcie. Jeśli uważasz, że się kwalifikujesz, skontaktuj się z nami, podając nazwę swojej aplikacji, firmę i logo.

Wgrywanie lotów

Jeśli twoja aplikacja musi jedynie wgrywać loty, nie potrzebujesz dostępu OAuth w ogóle. Możesz skorzystać z tego samego endpointu do wgrywania, którego używa projekt open source XCSoar.

Loggery mobilne są zatwierdzane ręcznie i wyłącznie dla plików ważnych w WeGlide (najniższy poziom bezpieczeństwa). Wymagają one co najmniej 500 użytkowników, a zatwierdzamy je, gdy zauważymy adopcję w społeczności.

Maps

Nasze mapy budujemy sami, z miłością i przy użyciu otwartych danych.

Są kompatybilne z większością nowoczesnego oprogramowania mapowego dzięki otwartym standardom, takim jak mapbox vector tiles oraz raster tiles.

Planujemy udostępnić nasze hostowane mapy jako usługę z uczciwym (czyt. tańszym niż Mapbox/Maptiler itp.) rozliczaniem. Skontaktuj się z nami, abyśmy wiedzieli, że jest na to zapotrzebowanie.