MQTT

Credențialele MQTT oferă integrărilor acces pub/sub în spațiul de nume de topicuri al organizației dumneavoastră. Credențialele le creați în Tillor la Cont > Dezvoltatori (per organizație). Accesul la topicuri este limitat la tillor/{env}/{orgId}/integration și subtopicurile sale ({env} = prod, staging sau local), cu excepția cazului în care o credențială statică are topicPrefix: null.

Pentru aceleași evenimente în timp real ca la webhookuri și SSE, folosiți acele canale, nu MQTT.

AdministrareCopiază linkul către această secțiune

Autentificare: x-api-key, cu ID-ul organizației în cale (la fel ca la API-ul HTTP). Consultați specificația OpenAPI pentru schemele complete de cerere și răspuns.

CredențialeCopiază linkul către această secțiune

Există două variante:

JWT (temporar)Copiază linkul către această secțiune

• Utilizare: sesiuni scurte, acces temporar
• Expirare: implicit 1 oră; configurabilă de la 1 minut la 24 de ore prin expiresInSeconds
• Ideal pentru: teste, conexiuni temporare sau când preluați tokenurile dinamic
• Creare: în Tillor la Cont > Dezvoltatori sau prin POST /api/orgs/:orgId/mqtt/credentials cu, opțional, { "clientId": "...", "expiresInSeconds": 3600 }
• Răspuns: token (folosiți-l ca parolă MQTT), clientId, brokerUrl, topicPrefix, expiresAt
• Nume de utilizator: lăsați gol la conectare; autentificarea JWT folosește doar tokenul ca parolă.
• ID client: folosiți exact clientId din răspuns la conectare (inclusiv prefixul de mediu, de ex. prod-).

O conexiune la broker prin mqtts verifică certificatul serverului. Dacă folosiți un certificat CA privat (nu lanțul public standard), setați PEM-ul acelui CA în mediul clientului dumneavoastră.

Credențiale staticeCopiază linkul către această secțiune

• Utilizare: integrări de lungă durată, conexiuni mereu active
• Formă: userName, clientId și password fixe
• Ideal pentru: integrări de producție care rămân conectate continuu
• Creare: în Tillor la Cont > Dezvoltatori sau prin POST /api/orgs/:orgId/mqtt/static-credentials cu, opțional, { "name": "mijn-integratie", "topicPrefix": null }
• Răspuns: userName, clientId, password (o singură dată), topicPrefix (null = fără prefix, ACL #), opțional brokerUrl
• Atenție: parola este afișată o singură dată în răspuns și nu mai poate fi preluată ulterior

---

Acces la topicuriCopiază linkul către această secțiune

Abonările la topicuri sunt strict limitate, cu excepția cazului în care topicPrefix este null (ACL #). Implicit puteți publica și vă puteți abona doar la tillor/{env}/{orgId}/integration și tillor/{env}/{orgId}/integration/#.

• Topicuri permise - doar tillor/{env}/{orgId}/integration și subtopicurile (de ex. tillor/{env}/{orgId}/integration/connector/access-point-operation)
• Fără ocolire prin wildcard - chiar și cu # sau + primiți acces doar la spațiul de nume al organizației dumneavoastră
• Per organizație - credențialele sunt per organizație; nu aveți acces la topicurile altor organizații

---

Legate de acest subiectCopiază linkul către această secțiune

• OpenAPI - specificația completă a API-ului
• API HTTP - API REST și chei API
• Webhookuri - aceleași evenimente prin HTTP POST
• SSE - evenimente în flux prin Server-Sent Events