MQTT

Dane uwierzytelniające MQTT dają integracjom dostęp pub/sub w przestrzeni nazw tematów Twojej organizacji. Tworzysz je w Tillor w Konto > Dla deweloperów (dla każdej organizacji). Dostęp do tematów jest ograniczony do tillor/{env}/{orgId}/integration i podtematów ({env} = prod, staging lub local), chyba że statyczne dane uwierzytelniające mają topicPrefix: null.

Dla tych samych zdarzeń czasu rzeczywistego co webhooki i SSE używaj tych kanałów, a nie MQTT.

ZarządzanieKopiuj link do tej sekcji

Uwierzytelnianie: x-api-key, z ID organizacji w ścieżce (tak samo jak w HTTP API). Pełne schematy żądań i odpowiedzi znajdziesz w specyfikacji OpenAPI.

Dane uwierzytelniająceKopiuj link do tej sekcji

Są dwa warianty:

JWT (tymczasowe)Kopiuj link do tej sekcji

• Zastosowanie: Krótkie sesje, tymczasowy dostęp
• Ważność: Domyślnie 1 godzina; konfigurowalna od 1 minuty do 24 godzin przez expiresInSeconds
• Idealne do: Testów, tymczasowych połączeń lub gdy pobierasz tokeny dynamicznie
• Tworzenie: W Tillor w Konto > Dla deweloperów lub przez POST /api/orgs/:orgId/mqtt/credentials z opcjonalnym { "clientId": "...", "expiresInSeconds": 3600 }
• Odpowiedź: token (użyj jako hasła MQTT), clientId, brokerUrl, topicPrefix, expiresAt
• Nazwa użytkownika: Zostaw puste przy łączeniu; uwierzytelnianie JWT używa tylko tokenu jako hasła.
• ID klienta: Przy łączeniu użyj dokładnie clientId z odpowiedzi (wraz z prefiksem środowiska, np. prod-).

Połączenie z brokerem przez mqtts sprawdza certyfikat serwera. Jeśli używasz prywatnego certyfikatu CA (a nie standardowego publicznego łańcucha), umieść PEM tego CA w środowisku swojego klienta.

Statyczne dane uwierzytelniająceKopiuj link do tej sekcji

• Zastosowanie: Długotrwałe integracje, połączenia zawsze włączone
• Postać: Stałe userName, clientId i password
• Idealne do: Integracji produkcyjnych, które pozostają stale połączone
• Tworzenie: W Tillor w Konto > Dla deweloperów lub przez POST /api/orgs/:orgId/mqtt/static-credentials z opcjonalnym { "name": "mijn-integratie", "topicPrefix": null }
• Odpowiedź: userName, clientId, password (jednorazowo), topicPrefix (null = brak prefiksu, ACL #), opcjonalnie brokerUrl
• Uwaga: Hasło jest pokazywane tylko raz w odpowiedzi i później nie można go już pobrać

---

Dostęp do tematówKopiuj link do tej sekcji

Subskrypcje tematów są ściśle ograniczone, chyba że topicPrefix ma wartość null (ACL #). Domyślnie możesz publikować i subskrybować tylko tillor/{env}/{orgId}/integration oraz tillor/{env}/{orgId}/integration/#.

• Dozwolone tematy - Tylko tillor/{env}/{orgId}/integration i podtematy (np. tillor/{env}/{orgId}/integration/connector/access-point-operation)
• Brak obejścia przez wildcard - Nawet z # lub + masz dostęp tylko do przestrzeni nazw swojej organizacji
• Per organizacja - Dane uwierzytelniające są przypisane do organizacji; nie masz dostępu do tematów innych organizacji

---

PowiązaneKopiuj link do tej sekcji

• OpenAPI - Pełna specyfikacja API
• HTTP API - REST API i klucze API
• Webhooki - Te same zdarzenia przez HTTP POST
• SSE - Strumieniowanie zdarzeń przez Server-Sent Events