Přeskočit na hlavní obsah
Tato stránka je překlad. Liší-li se od anglického originálu, platí anglické znění.
·Celý oddíl Stahování dat z našeho API (3 stránky)·Celá příručka Developers (35 stránek)

Začínáme s REST API

REST API se nejlépe hodí k získání aktuálních i historických telemetrických dat a k přístupu k datům účtu, jako jsou prostředky (assets), zařízení, letadla a další. Protože si data musíte sami vyžádat, není příliš vhodné pro streamování dat v reálném čase. Pro data v reálném čase doporučujeme naše endpointy Socket.io.

Získání přihlašovacích údajů k API​

Pro přístup k našemu API se musíte ověřit. Máte dvě možnosti:

  1. Osobní token: Osobním tokenem získáte přístup k datům na svém účtu Dronetag. Vytvoříte ho v naší aplikaci nebo přes API.
  2. OpenID Connect: OIDC slouží k pokročilejšímu ověřování a umožní vaší aplikaci přistupovat k soukromým datům jiných uživatelů.

Používání API​

Jakmile máte přihlašovací údaje, můžete API začít používat. Doporučujeme se nejprve seznámit s dokumentací API, která popisuje všechny dostupné endpointy a datové struktury, se kterými budete pracovat.

Datový formát DUMP​

Naše API používá řadu datových schémat, každé pro konkrétní prostředek API. Jedno z nich se ale napříč našimi službami používá nejjednotněji: formát Dronetag Unified Message Protocol (DUMP). Pokud pracujete s daty Remote ID, je pro vás porozumění tomuto protokolu obzvlášť důležité.

Připravili jsme podrobný návod, který rozebírá strukturu zpráv DUMP a vysvětluje, jak s nimi efektivně pracovat:

Podmínky pro parametry telemetrických požadavků​

Při telemetrických požadavcích na endpointy vzdušného prostoru (/v2/airspace/*) musíte vždy zadat časový rozsah (from a to) i geografickou oblast (bbox).

Z tohoto pravidla existuje několik výjimek:

  • Pokud zadáte operation_id, žádné další parametry nejsou potřeba.
  • Pokud zadáte uas_id, můžete vynechat geografickou oblast bbox, časový rozsah je ale stále povinný.

Velikost bbox je omezená a je určená pro středně velké oblasti. Pomocí bbox nelze pokrýt velká území, jako jsou celé státy, kontinenty nebo celý svět.

Pokud je pro vás tato podmínka problémem, doporučujeme podívat se na způsoby, jak vám data posíláme (Data Push).

Další návody​

Pro běžné případy použití našeho API máme několik dalších návodů. Ať už chcete získat aktuální stav vzdušného prostoru, nebo historická data, najdete v nich vše potřebné:

Další návody najdete v levém postranním panelu.