COME FUNZIONA

La comunicazione avviene in HTTP (GET/POST) ed è bidirezionale.

Invio di comandi verso l'esterno — la targa invia richieste HTTP a un endpoint esterno. Esistono due tipi di integrazione:

1. Tipo 0 (generico): invia GET o POST con un contenuto (body) configurabile verso indirizzi e porte diversi, decisi dall'integratore. Può essere legato a eventi (ad esempio la pressione di un pulsante, o un trigger di sensori/input). Per ogni endpoint si definiscono: Nome, Command (URL completo), Method (GET/POST) e Body data.
2. Tipo 1 (pensato per i server di domotica): invia tutti i comandi verso un unico indirizzo IP. Serve tipicamente a inviare le credenziali lette (PIN/QR) con una POST, nel formato {"value":"<valore del QR o del PIN inserito>"}. Per ogni endpoint si definiscono Nome, Path e Porta (l'indirizzo IP è unico e impostato a livello di integrazione). Nel dubbio, per la domotica conviene partire dal Tipo 1.

Se il server di terze parti risponde con stato 200 e body {"text":"<messaggio>"}, la targa pronuncia/mostra il messaggio.

Ricezione di comandi dall'esterno — la targa può ricevere comandi HTTP sotto forma di input virtuali (vedi la scheda Input virtuali): il server esterno richiama l'URL dell'input virtuale e la targa esegue l'azione associata (ad esempio aprire la serratura oppure pronunciare un messaggio).