Přeskočit na hlavní obsah
Sloučeno do jednoho dokumentu: 3 stránky. Tip: v tiskovém dialogu zapněte volbu Grafika na pozadí, aby si poznámky a upozornění zachovaly podbarvení.
Všechny příručky k tisku
Dronetag
Developers

Typy distribucí

Dokument
Developers — Typy distribucí
Kapitoly
3
Zdroj
help.dronetag.cz/cs/print/developers/data-push/distribution-types
Dronetag s.r.o. · Rozhodující je vždy aktuální online verze tohoto dokumentu.
Tento dokument je překlad. Liší-li se od anglického originálu na adrese help.dronetag.cz/print/developers/data-push/distribution-types, platí anglické znění.

HTTP Webhooks

Nejběžnější typ distribuce posílá data protokolem HTTP.
Pro každou telemetrickou zprávu se vytvoří nový HTTP požadavek a odešle se na HTTP server vaší služby.

Specifická konfigurace​

Ve specifické konfiguraci lze zatím nastavit jen další HTTP hlavičky.

NázevPopisPlatné hodnoty
target_additional_http_headersDalší HTTP hlavičky odesílané s každým požadavkemobjekt JSON

Příklad specifické konfigurace​

Následuje příklad konfiguračního JSON, ve kterém se pomocí vlastních hlaviček posílá s každým požadavkem Bearer token.

{
"target_additional_http_headers": {
"X-My-Custom-Id": "12345"
}
}

MQTT Client

Pokud vaše služba provozuje server brokeru MQTT, můžete použít typ MQTT Client, který se k vašemu serveru připojí a data na něm publikuje.

Specifická konfigurace​

NázevPopisPlatné hodnoty
mqtt_dist_client_idClient ID pro MQTTLibovolný řetězec
mqtt_dist_transportTyp přenosu použitý pro připojení k serverutcp nebo websockets
mqtt_dist_tlsZda se má k připojení použít TLStrue nebo false
mqtt_dist_json_datastream_topicTéma (topic) pro odesílání telemetrických zprávLibovolný řetězec
mqtt_dist_publish_qos_defaultParametr QoS zpráv odesílaných klientemLibovolné celé číslo
embed_metadataPřidá do obsahu zprávy metadata jako account_visibility nebo integration_client_idtrue nebo false

Příklad specifické konfigurace​

Následuje příklad konfiguračního JSON.

{
"mqtt_dist_client_id": "dronetag_0001",
"mqtt_dist_transport": "tcp",
"mqtt_dist_tls": false,
"mqtt_dist_json_datastream_topic": "dronetag/telemetry/{msgtype}",
"mqtt_dist_publish_qos_default": 0
}

Použití {msgtype} v názvu tématu​

Pokud používáte formát Dronetag DUMP a chcete posílat různé typy zpráv do různých témat, můžete do názvu tématu vložit zástupný text {msgtype}. Před odesláním se nahradí skutečným typem zprávy. Je-li typem zprávy například „UA telemetry“, z tématu dronetag/telemetry/{msgtype} se stane dronetag/telemetry/tele-ua.

Dostupné typy zpráv:

  • tele-ua - zprávy s telemetrií UA
  • tele-operator - zprávy s telemetrií operátora
  • tele-system - zprávy se systémovou telemetrií
  • operation-update - zprávy o změně operace

Více o typech zpráv najdete na stránce Zprávy DUMP.

Doporučení ke konfiguraci​

  • Obvykle je nutné nastavit platný Target Port.

TCP a UDP sockety

Tento typ distribuce posílá data přes obyčejný TCP nebo UDP socket.

Specifická konfigurace​

NázevPopisPlatné hodnoty
embed_metadataPřidá do obsahu zprávy metadata jako account_visibility nebo integration_client_idtrue nebo false

Příklad specifické konfigurace​

Následuje příklad konfiguračního JSON

{
"embed_metadata": true
}

Doporučení ke konfiguraci​

  • Musí být nastavený 'Target port'
  • Pro zabezpečení provozu doporučujeme typ autorizace AES cipher

Zdrojové stránky

Každá kapitola tohoto dokumentu je stránkou nápovědy Dronetag. Na těchto adresách najdete vždy aktuální verzi.

  1. 1HTTP Webhookshelp.dronetag.cz/cs/developers/data-push/distribution-types/http
  2. 2MQTT Clienthelp.dronetag.cz/cs/developers/data-push/distribution-types/mqtt
  3. 3TCP a UDP socketyhelp.dronetag.cz/cs/developers/data-push/distribution-types/tcp