Gateway Tuya / SmartLife

API e webhooks para o ecossistema Tuya

Conecte contas SmartLife, integre fechaduras, câmeras e automações via /gateway/v1 e use a documentação interativa para prototipar antes de ir para produção.

Documentação para integradores

Referência OpenAPI publicada, exemplos por endpoint e Try it no navegador — sem montar Postman do zero.

  • Contrato /gateway/v1 com spaces, devices, locks, câmeras, cenas e eventos.
  • Try it com sua conta SmartLife: 10 chamadas/hora grátis no explorador.
  • Autenticação produção com Authorization: Bearer mira_live_… e medição por tokens.
Abrir documentação API
GET /gateway/v1/spaces
POST /gateway/v1/devices/{id}/commands
POST /gateway/v1/locks/{id}/unlock

Try it · OpenAPI · pt-BR / es

Casos de uso

O mesmo gateway atende operações humanas no painel e automações via API.

Hospitalidade e locação

Check-in remoto, cenas de boas-vindas, fechaduras e câmeras por unidade.

Acesso e fechaduras

Trancar/destrancar, campainha e webhooks para PMS ou visitantes.

Monitoramento

Wall de câmeras, streams e alarmes no seu backend.

Automação e integrações

Cenas, comandos em lote e encaixe em CRM ou ERP.

Quanto custa por mês?

Simule um fluxo real de locação: seu PMS dispara destrave e cena no check-in, recebe webhooks de campainha e acesso durante a estadia, e tranca na saída. O painel operacional continua gratuito.

Média de reservas concluídas — cada estadia dispara o fluxo completo abaixo (API + webhooks).

Estimativa mensual (30 dias)

créditos / mês
custo estimado
estadias / mês
Chamadas API: Webhooks entregues:

Tokens medidos no JSON de entrada e saída (API) e no payload de webhook. Streams de câmera excluídos. Try it na documentação: 10 chamadas/hora grátis.

API /gateway/v1

REST estável para o que o app SmartLife já enxerga na conta vinculada.

Webhooks

Eventos de campainha, destrave e movimento para o seu servidor.

Créditos por tokens

Pré-pago via Stripe — entrada e saída JSON medidos como tokens.

Painel operacional gratuito — controle humano, câmeras, fechaduras e automação sem débito de créditos na API do painel.
Tuya Gateway Tuya / SmartLife Painel operacional Docs

Centro de comando

Ao vivo
API

Nenhum dispositivo.

Gateway API

Painel e controle manual são gratuitos. Integrações via /gateway/v1 consomem créditos (tokens).

Smart Life não conectado Associe uma conta Smart Life para usar o painel operacional (dispositivos, câmeras, fechaduras).

Conectar Smart Life

User Code + QR code no app Smart Life.

Perfil → Settings → Account and Security

Conectando à Tuya…

QR Code

Smart Life → Perfil → Scan

Aguardando confirmação…

Smart Life conectado:

Organização

Créditos

Configure STRIPE_SECRET_KEY no servidor.

Histórico de transações

Uso e custos

API Keys

Base: Authorization: Bearer mira_live_…documentação interativa.

Webhooks

Administração

Visão global de organizações, usuários e billing.

Organizações

Conceder bônus

Usuários

Dispositivo

Carregando…