Ecosistema connectat

Integracions i API.
Onzane no treballa aïllada.

Connecta el programari que ja utilitza la teva organització amb Onzane mitjançant l’API Business i incorpora dispositius de tercers per portar la plataforma fins a l’espai físic.

Veure el model d’integració Consultar l’API Business

Una plataforma oberta on aporta valor

Integra dades, processos
i espais físics.

Cada integració parteix d’una necessitat concreta. Onzane manté el context de la comunitat mentre el sistema extern o el dispositiu aporta la capacitat especialitzada.

  1. 01

    Sistema extern

    El programari, procés o dispositiu que ha d’intercanviar informació o executar una acció.

  2. 02

    Capa d’integració

    API, credencials, regles i adaptadors controlen com es produeix la connexió.

  3. 03

    Onzane

    La informació queda relacionada amb comunitats, propietats, residents, permisos i operacions.

Una integració útil evita duplicitats sense perdre el control sobre qui pot accedir a cada dada o acció.

Integració amb programari

API Business per connectar
l’operativa de la teva organització.

L’API Business permet que aplicacions autoritzades es comuniquin amb Onzane mitjançant HTTPS i JSON. El contracte públic actual inclou operacions financeres sobre comunitats i propietats, a més de consultes sobre la situació de residents.

Àmbit documentat actualment

Finances de comunitat
Consulta i gestió de moviments financers vinculats a una comunitat.
Finances de propietat
Operacions sobre moviments associats a un habitatge, local, garatge o una altra propietat.
Situació de residents
Localització dins de l’àmbit autoritzat i consulta de la seva situació i incidències obertes.

Accés tècnic sota control

Token Bearer
Cada integració s’autentica amb una credencial Business.
Àmbit definit
El token queda lligat a l’usuari i a la seva administració d’Onzane.
Credencial revocable
Es pot substituir o revocar des del panell quan sigui necessari.
Contracte versionat
La referència tècnica també es publica com a OpenAPI 3.0.3.

Integració amb dispositius

Maquinari de tercers.
L’edifici també es connecta.

Onzane s’integra amb fabricants especialitzats quan el dispositiu aporta una funció física concreta. La compatibilitat es valida per model, instal·lació i cas d’ús.

01Watchman Door

Panys i accessos

Integració amb panys compatibles per aplicar permisos d’Onzane en determinats punts d’accés.

02Shelly

Relés i actuació

Relés per accionar portes, circuits o mecanismes compatibles des de regles i permisos de la plataforma.

03Shelly

Sensors i estats

Sensors compatibles per rebre estats o mesures i relacionar-los amb instal·lacions comunitàries.

Shelly és l’ecosistema de maquinari recomanat per Onzane per a noves implantacions compatibles.

Explorar la domòtica comunitària

Connectar amb un propòsit

La integració comença
pel resultat que necessites.

L’abast es defineix segons les dades, els processos i les accions que han de compartir Onzane i el sistema extern.

01

Programari de gestió

Reduir la introducció duplicada de dades i mantenir coordinats determinats processos.

02

Processos financers

Intercanviar moviments de comunitat o propietat dins de l’àmbit publicat per l’API Business.

03

Control d’accessos

Convertir permisos digitals en accions sobre panys, relés i altres equips compatibles.

04

Supervisió d’instal·lacions

Recollir senyals de sensors i conservar-los amb el context de la instal·lació.

Implantació tècnica acompanyada

Primer definim l’intercanvi.
Després connectem.

Una integració estable necessita identificar sistemes, responsables, dades, permisos i comportament davant d’errors abans de passar a producció.

  1. 01Analitzem

    Concretem l’objectiu, els sistemes implicats i el flux actual.

  2. 02Delimitem

    Definim dades, operacions, permisos, freqüència i responsabilitats.

  3. 03Integrem

    Configurem credencials o dispositius i desenvolupem l’adaptador quan cal.

  4. 04Validem

    Provem casos normals, errors, revocació i traçabilitat abans d’activar.

No totes les connexions són iguals.

Algunes es resolen amb el contracte actual de l’API Business o amb dispositius ja compatibles. Altres requereixen una anàlisi i un desenvolupament específics.

Abans de connectar

Preguntes sobre integracions i API.

L’abast real depèn del sistema extern, el flux, l’àmbit de dades i la instal·lació física.

01Què és l’API Business d’Onzane?

És l’API per connectar aplicacions de tercers amb Onzane mitjançant HTTPS i respostes JSON. Utilitza tokens Bearer associats a un usuari i a la seva administració.

02Quines operacions ofereix actualment?

La referència pública actual inclou operacions financeres sobre comunitats i propietats i consultes sobre la situació de residents. El contracte pot evolucionar de manera versionada.

03Podem integrar el nostre programari actual?

Sí, quan el flux necessari està cobert per l’API o es pot desenvolupar una integració específica. Abans es revisen dades, permisos, volum i comportament esperat.

04Com es controla l’accés a l’API?

Cada integració utilitza un token Business associat a un usuari i al seu àmbit d’administració. La credencial es pot revocar o substituir.

05Amb quin maquinari s’integra Onzane?

Actualment Onzane disposa d’integracions per a determinats dispositius de Watchman Door i Shelly. Shelly és l’opció recomanada per a noves implantacions compatibles.

06Qualsevol dispositiu d’aquests fabricants és compatible?

No necessàriament. Depèn del model, firmware, connectivitat, instal·lació i cas d’ús. Onzane valida cada projecte abans d’implantar-lo.

Connecta sense duplicar

Explica’ns quin sistema o dispositiu necessites integrar.

Revisarem el flux, l’àmbit disponible i la manera més segura de connectar-lo amb Onzane.

Estudiar la meva integració