MQTT

MQTT-Zugangsdaten geben Integrationen Pub/Sub-Zugriff innerhalb des Topic-Namespace Ihrer Organisation. Die Zugangsdaten legen Sie in Tillor unter Konto > Entwickler an (pro Organisation). Der Zugriff auf Topics ist auf tillor/{env}/{orgId}/integration und Untertopics beschränkt ({env} = prod, staging oder local), es sei denn, eine statische Zugangsdaten-Kombination hat topicPrefix: null.

Für dieselben Echtzeit-Events wie bei Webhooks und SSE verwenden Sie diese Kanäle, nicht MQTT.

VerwaltungLink zu diesem Abschnitt kopieren

Authentifizierung: x-api-key, mit der Organisations-ID im Pfad (wie bei der HTTP API). Die vollständigen Request- und Response-Schemas finden Sie in der OpenAPI-Spezifikation.

ZugangsdatenLink zu diesem Abschnitt kopieren

Es gibt zwei Varianten:

JWT (temporär)Link zu diesem Abschnitt kopieren

• Verwendung: Kurze Sitzungen, temporärer Zugriff
• Ablauf: Standardmäßig 1 Stunde; über expiresInSeconds von 1 Minute bis 24 Stunden einstellbar
• Ideal für: Tests, temporäre Verbindungen oder wenn Sie Tokens dynamisch abrufen
• Anlegen: In Tillor unter Konto > Entwickler, oder über POST /api/orgs/:orgId/mqtt/credentials mit optional { "clientId": "...", "expiresInSeconds": 3600 }
• Response: token (als MQTT-Passwort verwenden), clientId, brokerUrl, topicPrefix, expiresAt
• Benutzername: Beim Verbinden leer lassen; die JWT-Authentifizierung verwendet nur das Token als Passwort.
• Client-ID: Verwenden Sie beim Verbinden genau die clientId aus der Response (einschließlich des Umgebungspräfixes, z. B. prod-).

Eine Verbindung zum Broker über mqtts prüft das Serverzertifikat. Verwenden Sie ein privates CA-Zertifikat (nicht die standardmäßige öffentliche Kette), legen Sie die PEM dieser CA in Ihrer Client-Umgebung ab.

Statische ZugangsdatenLink zu diesem Abschnitt kopieren

• Verwendung: Langlaufende Integrationen, dauerhafte Verbindungen
• Form: Fester userName, clientId und password
• Ideal für: Produktiv-Integrationen, die dauerhaft verbunden bleiben
• Anlegen: In Tillor unter Konto > Entwickler, oder über POST /api/orgs/:orgId/mqtt/static-credentials mit optional { "name": "mijn-integratie", "topicPrefix": null }
• Response: userName, clientId, password (einmalig), topicPrefix (null = kein Präfix, ACL #), optional brokerUrl
• Achtung: Das Passwort wird nur einmal in der Response angezeigt und kann danach nicht mehr abgerufen werden

---

Topic-ZugriffLink zu diesem Abschnitt kopieren

Topic-Subscriptions sind streng beschränkt, es sei denn, topicPrefix ist null (ACL #). Standardmäßig können Sie nur auf tillor/{env}/{orgId}/integration und tillor/{env}/{orgId}/integration/# publizieren und abonnieren.

• Erlaubte Topics - Nur tillor/{env}/{orgId}/integration und Untertopics (z. B. tillor/{env}/{orgId}/integration/connector/access-point-operation)
• Keine Wildcard-Umgehung - Auch mit # oder + erhalten Sie nur Zugriff auf den Namespace Ihrer Organisation
• Pro Organisation - Zugangsdaten gelten pro Organisation; Sie haben keinen Zugriff auf Topics anderer Organisationen

---

VerwandtLink zu diesem Abschnitt kopieren

• OpenAPI - Vollständige API-Spezifikation
• HTTP API - REST API und API-Schlüssel
• Webhooks - Dieselben Events über HTTP POST
• SSE - Events als Stream über Server-Sent Events