V rámci vylepšení přechází Dronetag na získávání telemetrie podle oblasti a podle časového úseku. Při dotazech na telemetrii a data v reálném čase proto musíte nově zadat geografickou oblast nebo časový rozsah. Postupujte podle tohoto průvodce, aby přechod na nový systém proběhl hladce.

Čeho se změna týká​

• Všech HTTP požadavků na telemetrii po letu z api.dronetag.app
  • Endpointy:
    • https://api.dronetag.app/v1/flights/*/telemetry*
    • https://api.dronetag.app/v1/devices/*/status-history
• Všech HTTP požadavků na živou telemetrii z live.dronetag.app
  • Endpointy:
    • https://live.dronetag.app/api/v2/airspace/overview
    • https://live.dronetag.app/api/v2/devices/*/telemetry
    • https://live.dronetag.app/api/v2/devices/*/status_history
    • https://live.dronetag.app/api/v2/flights/*/telemetry
• Všech spojení Socket.IO pro letovou telemetrii v reálném čase z live.dronetag.app

Hlavní změny​

• Pro každé získání telemetrie je nyní nutné zadat geografické hranice nebo UAS ID (sériové číslo zařízení).
• Létající objekty už služba neidentifikuje podle UAS ID, ale podle Operation ID.
• Naše telemetrické endpointy nyní používají nový datový formát DUMP, který budou jednotně používat všechny naše služby.
• Několik endpointů, mezi nimi https://live.dronetag.app/api/v2/airspace/overview, bude do února 2025 označeno jako zastaralé (deprecated).

Harmonogram migrace​

• Únor 2025: Všechny zastaralé endpointy API a Socket.IO na live.dronetag.app budou odstraněny. Do tohoto data dokončete migraci.

Migrace krok za krokem​

1. Pro získávání telemetrie přejděte na api.dronetag.app/v2/airspace​

Při získávání telemetrie nahraďte dotazy na live.dronetag.app dotazy na api.dronetag.app/v2/airspace.

Náhrada za GET https://live.dronetag.app/api/v2/airspace/overview​

• Použijte GET https://api.dronetag.app/v2/airspace/telemetry/ua.
• Zadejte časový rozsah, geografické hranice nebo UAS ID.
• Poznámka: Létající objekty se nyní identifikují podle Operation ID. UAS ID zjistíte přes /operations/{operation_id}.

Náhrada za GET https://live.dronetag.app/api/v2/devices/*/telemetry​

• Použijte GET https://api.dronetag.app/v2/airspace/telemetry/ua?uas_id=xxx s filtrem podle UAS ID.
• K zjištění UAS ID budete možná potřebovat /operations/{operation_id}.

Náhrada za GET https://live.dronetag.app/api/v2/devices/*/status_history​

• Historie stavu zařízení je nyní součástí systémové telemetrie.
• Použijte GET https://api.dronetag.app/v2/airspace/telemetry/system?uas_id=xxx s filtrem podle UAS ID.

Náhrada za GET https://live.dronetag.app/api/v2/flights/*/telemetry​

• Letová telemetrie je nyní vázaná na Operation ID.
• Použijte GET https://api.dronetag.app/v2/airspace/telemetry/ua?operation_id=xxx.

2. Pro spojení Socket.IO přejděte na api.dronetag.app/v2/airspace​

• Služby Socket.IO na live.dronetag.app budou ukončeny. Pro telemetrii v reálném čase používejte api.dronetag.app/v2/airspace.
• Po připojení pošlete zprávu viewport, kterou určíte sledovanou geografickou oblast. Novou zprávu viewport pošlete pokaždé, když se oblast změní, a také po každém opětovném připojení.
• Podrobnosti najdete na stránce Začínáme se Socket.io.

3. Pro data po letu přejděte na api.dronetag.app/v2/airspace​

Telemetrie po letu se nyní získává přes stejné API jako data v reálném čase. V nových požadavcích použijte své flight_id jako operation_id.

Náhrada za GET https://api.dronetag.app/v1/flights/*/telemetry*​

• Použijte GET https://api.dronetag.app/v2/airspace/telemetry/ua?operation_id=xxx s Operation ID a časem začátku a konce letu.

Náhrada za GET https://api.dronetag.app/v1/flights/*/status-history*​

• Použijte GET https://api.dronetag.app/v2/airspace/telemetry/system?operation_id=xxx s Operation ID a časem začátku a konce letu.

Postupně vylepšujeme naši cloudovou platformu, a proto je nutné převést váš způsob ověřování na nový systém. Tento průvodce vám pomůže přejít na přepracovanou ověřovací vrstvu, která přináší vyšší zabezpečení, lepší kompatibilitu a podporu OpenID Connect (OIDC). Postupujte podle kroků níže, aby přechod proběhl hladce.

Čeho se změna týká​

• Všech požadavků na API – autorizovaných i neautorizovaných.
• Všech požadavků na ověření – změnili jsme službu, která vydává přístupové tokeny.

Hlavní změny​

• Zastaralé endpointy: Stávající autorizační endpointy API (https://api.dronetag.app/v1/auth/*) jsou nyní zastaralé (deprecated). Musíte přejít na novou službu (https://auth.dronetag.app).
• Přihlašovací údaje OAuth 2.0: K přihlášení budou nově potřeba přihlašovací údaje aplikace OAuth 2.0. Dokud nebude k dispozici automatizovaná správa OAuth 2.0, vydáváme je ručně.

Harmonogram migrace​

• Do konce února 2025: Původní autorizační endpointy budou úplně odstraněny. Všechny autorizační požadavky musí do té doby přejít na novou službu.

Migrace krok za krokem​

1. Použijte knihovnu pro OpenID Connect (OIDC) (doporučeno)​

Přechod si nejvíce usnadníte, když použijete existující knihovnu OIDC pro OAuth 2.0. Tyto knihovny obsluhují celý tok OAuth 2.0 včetně přístupových tokenů, obnovovacích tokenů (refresh token) a dalších úloh souvisejících s OIDC.

Seznam certifikovaných implementací OIDC najdete zde: OpenID Connect Certified Libraries.

2. Převeďte autorizační požadavky na novou ověřovací službu​

Všechny autorizační požadavky musí směřovat na nový endpoint:

• Původní endpoint: POST https://api.dronetag.app/v1/auth/jwt/token
• Nový endpoint: POST https://auth.dronetag.app/realms/master/protocol/openid-connect/token

Upravte logiku požadavků tak, aby mířila na novou URL, a počítejte s jinou strukturou odpovědi JSON. Nová odpověď obsahuje mimo jiné pole access_token a refresh_token.