Skip to main content

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.
  1. No Portal, crie automação com gatilho Webhook e copie a URL.
  2. No GitHub, adicione webhook em Settings → Webhooks com application/json.
  3. 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:
  1. Cada cliente final gera um PAT e cola na sua aplicação.
  2. Cada cliente seleciona qual organização do Portal usar.
  3. Sua aplicação armazena { user_id, portal_token, portal_org_id }.
  4. 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.