MQTT

Les identifiants MQTT donnent aux intégrations un accès pub/sub dans l'espace de noms de topics de votre organisation. Vous créez les identifiants dans Tillor sous Compte > Développeurs (par organisation). L'accès aux topics est limité à tillor/{env}/{orgId}/integration et à ses sous-topics ({env} = prod, staging ou local), sauf si un identifiant statique a topicPrefix: null.

Pour les mêmes événements en temps réel que les webhooks et le SSE, utilisez ces canaux, pas MQTT.

GestionCopier le lien vers cette section

Authentification : x-api-key, avec l'ID de l'organisation dans le chemin (comme pour l'API HTTP). Consultez la spécification OpenAPI pour les schémas complets de requête et de réponse.

IdentifiantsCopier le lien vers cette section

Il en existe deux variantes :

JWT (temporaire)Copier le lien vers cette section

• Usage : sessions courtes, accès temporaire
• Expiration : 1 heure par défaut ; configurable de 1 minute à 24 heures via expiresInSeconds
• Idéal pour : les tests, les connexions temporaires, ou lorsque vous récupérez les jetons dynamiquement
• Création : dans Tillor sous Compte > Développeurs, ou via POST /api/orgs/:orgId/mqtt/credentials avec, en option, { "clientId": "...", "expiresInSeconds": 3600 }
• Réponse : token (à utiliser comme mot de passe MQTT), clientId, brokerUrl, topicPrefix, expiresAt
• Nom d'utilisateur : laissez-le vide à la connexion ; l'authentification JWT utilise uniquement le jeton comme mot de passe.
• Client ID : utilisez exactement le clientId de la réponse à la connexion (préfixe d'environnement compris, par ex. prod-).

Une connexion au broker via mqtts vérifie le certificat du serveur. Si vous utilisez un certificat d'AC privée (et non la chaîne publique habituelle), placez le PEM de cette AC dans l'environnement de votre client.

Identifiants statiquesCopier le lien vers cette section

• Usage : intégrations de longue durée, connexions permanentes
• Forme : userName, clientId et password fixes
• Idéal pour : les intégrations de production qui restent connectées en continu
• Création : dans Tillor sous Compte > Développeurs, ou via POST /api/orgs/:orgId/mqtt/static-credentials avec, en option, { "name": "mijn-integratie", "topicPrefix": null }
• Réponse : userName, clientId, password (une seule fois), topicPrefix (null = aucun préfixe, ACL #), brokerUrl en option
• Attention : le mot de passe n'est affiché qu'une seule fois dans la réponse et ne peut plus être récupéré ensuite

---

Accès aux topicsCopier le lien vers cette section

Les abonnements aux topics sont strictement limités, sauf si topicPrefix vaut null (ACL #). Par défaut, vous ne pouvez publier et vous abonner que sur tillor/{env}/{orgId}/integration et tillor/{env}/{orgId}/integration/#.

• Topics autorisés - uniquement tillor/{env}/{orgId}/integration et ses sous-topics (par ex. tillor/{env}/{orgId}/integration/connector/access-point-operation)
• Pas de contournement par joker - même avec # ou +, vous n'accédez qu'à l'espace de noms de votre organisation
• Par organisation - les identifiants sont propres à une organisation ; vous n'avez pas accès aux topics des autres organisations

---

Voir aussiCopier le lien vers cette section

• OpenAPI - spécification complète de l'API
• API HTTP - API REST et clés API
• Webhooks - mêmes événements via HTTP POST
• SSE - flux d'événements via Server-Sent Events