MQTT

Las credenciales MQTT dan a las integraciones acceso pub/sub dentro del espacio de nombres de topics de tu organización. Las credenciales se crean en Tillor en Cuenta > Desarrolladores (por organización). El acceso a los topics se limita a tillor/{env}/{orgId}/integration y sus subtopics ({env} = prod, staging o local), salvo que una credencial estática tenga topicPrefix: null.

Para los mismos eventos en tiempo real que con webhooks y SSE, usa esos canales, no MQTT.

GestiónCopiar el enlace a esta sección

Autenticación: x-api-key, con el ID de la organización en la ruta (igual que en la API HTTP). Consulta la especificación OpenAPI para los esquemas completos de petición y respuesta.

CredencialesCopiar el enlace a esta sección

Hay dos variantes:

JWT (temporal)Copiar el enlace a esta sección

• Uso: Sesiones cortas, acceso temporal
• Caducidad: Por defecto 1 hora; configurable de 1 minuto a 24 horas mediante expiresInSeconds
• Ideal para: Pruebas, conexiones temporales, o cuando obtienes los tokens de forma dinámica
• Creación: En Tillor en Cuenta > Desarrolladores, o mediante POST /api/orgs/:orgId/mqtt/credentials con, opcionalmente, { "clientId": "...", "expiresInSeconds": 3600 }
• Respuesta: token (úsalo como contraseña MQTT), clientId, brokerUrl, topicPrefix, expiresAt
• Nombre de usuario: Déjalo vacío al conectar; la autenticación JWT solo usa el token como contraseña.
• Client ID: Usa exactamente el clientId de la respuesta al conectar (incluido el prefijo de entorno, p. ej. prod-).

Una conexión al broker mediante mqtts comprueba el certificado del servidor. Si usas un certificado de CA privada (no la cadena pública estándar), pon el PEM de esa CA en el entorno de tu cliente.

Credenciales estáticasCopiar el enlace a esta sección

• Uso: Integraciones de larga duración, conexiones siempre activas
• Forma: userName, clientId y password fijos
• Ideal para: Integraciones de producción que permanecen conectadas de forma continua
• Creación: En Tillor en Cuenta > Desarrolladores, o mediante POST /api/orgs/:orgId/mqtt/static-credentials con, opcionalmente, { "name": "mijn-integratie", "topicPrefix": null }
• Respuesta: userName, clientId, password (una sola vez), topicPrefix (null = sin prefijo, ACL #), opcionalmente brokerUrl
• Atención: La contraseña se muestra una sola vez en la respuesta y después ya no se puede recuperar

---

Acceso a topicsCopiar el enlace a esta sección

Las suscripciones a topics están estrictamente limitadas, salvo que topicPrefix sea null (ACL #). Por defecto solo puedes publicar y suscribirte a tillor/{env}/{orgId}/integration y tillor/{env}/{orgId}/integration/#.

• Topics permitidos - Solo tillor/{env}/{orgId}/integration y sus subtopics (p. ej. tillor/{env}/{orgId}/integration/connector/access-point-operation)
• Sin saltarse el límite con comodines - Incluso con # o + solo obtienes acceso al espacio de nombres de tu organización
• Por organización - Las credenciales son por organización; no tienes acceso a los topics de otras organizaciones

---

RelacionadoCopiar el enlace a esta sección

• OpenAPI - especificación completa de la API
• API HTTP - API REST y claves de API
• Webhooks - los mismos eventos mediante HTTP POST
• SSE - recibe eventos en streaming mediante Server-Sent Events