Exemplos Praticos
Receitas prontas combinando varios endpoints da API. Adapte ao seu stack.
1. Sincronizar dashboard externo
Mostre o estado de todas as entidades do usuário num painel próprio.
2. Acionar luz a partir de um sistema legado
Seu ERP detectou que o turno acabou — apague tudo na loja.
3. Disparar automação por webhook do GitHub
Configure um webhook do GitHub apontando para a URL de webhook de uma automação. Quando alguem abrir uma issue, a automação envia uma notificação no Aplicativo Móvel.
- No Portal, crie automação com gatilho Webhook e copie a URL.
- No GitHub, adicione webhook em Settings → Webhooks com
application/json.
- Pronto — o body do GitHub fica disponível em
{{ trigger.json }} nas ações.
4. Relatório diario de consumo (histórico)
5. Bot do Telegram que liga a luz
6. n8n / Zapier / Make
Configure um nodo HTTP request com:
- Method:
POST
- URL:
https://portal.unicontrol.me/v1/service/{domain}/{service}
- Headers:
Authorization: Bearer pat_...
- Body (JSON):
{ "entity_id": "...", "data": { ... } }
Para receber eventos do Portal, exponha um endpoint no n8n/Zapier e configure uma automação com ação Chamar URL apontando para ele.
7. Multi-tenant SaaS sobre o Portal
Você esta construindo um SaaS que opera sobre varias contas Portal. Padrão recomendado:
- Cada cliente final gera um PAT e cola na sua aplicação.
- Cada cliente seleciona qual organização do Portal usar.
- Sua aplicação armazena
{ user_id, portal_token, portal_org_id }.
- Cada chamada usa esses três valores nos headers.
Eduque seus usuários a revogar o token no Portal quando descontratarem sua plataforma — isso garante que você perde o acesso imediatamente.