
A integração de fechaduras numa app, num PMS ou numa plataforma de edifícios é feita através de dois conjuntos de ferramentas distintos: APIs de cloud para operações remotas e SDKs Bluetooth para controlo pelo telefone quando se encontra próximo. Confundi-los é o erro mais comum no planeamento da integração.
Quando uma aplicação de terceiros precisa de operar fechaduras inteligentes — um canal de aluguer que emite códigos, uma plataforma de escritórios que provisiona visitantes ou uma app de hotel que entrega chaves móveis — o fornecedor da fechadura disponibiliza interfaces programáveis em duas camadas. A API de cloud é normalmente um serviço de estilo REST sobre HTTPS: a aplicação autentica-se com credenciais de estilo OAuth, cria códigos de acesso ou chaves eletrónicas, envia comandos de desbloqueio remoto para fechaduras online, consulta o estado das fechaduras e recebe callbacks de webhook para eventos de desbloqueio, bateria fraca e tentativa de adulteração. O SDK móvel é uma biblioteca integrada na app iOS ou Android do integrador que gere a descoberta Bluetooth, a ligação segura, o desbloqueio nas imediações e a lógica de credenciais offline sem recorrer ao servidor. As integrações bem-sucedidas utilizam deliberadamente as duas camadas, protegem as suas credenciais e testam os limites de caudal e a entrega de eventos antes do lançamento. Este guia mapeia os conceitos e as perguntas ao fornecedor que são relevantes. A disponibilidade, os âmbitos e as licenças da API e do SDK para cada plataforma são confirmados por escrito em cada cotação.
| API de cloud | Serviços HTTPS gerem fechaduras, credenciais e eventos a partir de um servidor; chegam apenas a portas remotas quando as fechaduras estão online através de Wi-Fi ou de um gateway. |
| SDK móvel | Bibliotecas iOS/Android integradas tratam da ligação Bluetooth, do desbloqueio nas imediações e da lógica offline dentro da app do integrador. |
| Autenticação | Credenciais de cliente de estilo OAuth, tokens com âmbitos específicos e webhooks assinados separam plataformas profissionais de scripts de retransmissão abertos. |
| Credenciais por API | As operações mais comuns criam códigos de acesso datados, chaves eletrónicas, cartões e ligações para visitantes, com endpoints de listagem, atualização e revogação. |
| Entrega de eventos | Os webhooks notificam desbloqueios, utilização de códigos, bateria fraca e eventos das portas; o comportamento de novas tentativas e as garantias de ordenação devem estar documentados. |
| Dependência de hardware | Os comandos remotos apenas são executados em fechaduras online através de Wi-Fi ou de um gateway, pelo que a conceção da API e a topologia do hardware devem ser planeadas em conjunto. |
| A nossa política | Fornecemos documentação das interfaces, sandbox ou dispositivos de teste e um contacto técnico; as credenciais e os limites de produção provêm do acordo da plataforma. |
A automatização do lado do servidor (canais de aluguer, PMS, gestão de visitantes) assenta na API de cloud; as apps de telefone de marca com controlo nas imediações ou offline acrescentam o SDK móvel. Os produtos que precisam das duas opções devem definir o modelo de credenciais antes de escrever código.
| Objetivo da integração | Conjunto principal de ferramentas | Dependência essencial |
|---|---|---|
| Emitir códigos de aluguer datados | API de cloud a partir do backend de reservas | As fechaduras suportam o tipo de código e o caminho de sincronização pretendidos. |
| App de inquilino com marca | SDK móvel e API de cloud | A equipa da app gere a versão do SDK e a revisão pela loja. |
| Entrega de chave móvel de hotel | Eventos da API de cloud a partir do middleware do PMS | Cobertura do serviço de credenciais e do gateway nas portas. |
| Quiosque de gestão de visitantes | API de cloud para credenciais de utilization única | Fusos horários e semântica de expiração validados antecipadamente. |
| Concierge remoto em tempo real | Desbloqueio pela API de cloud e confirmação por webhook | Apenas as fechaduras online executam comandos remotos de imediato. |
| Carteira empresarial offline | SDK móvel com credenciais locais protegidas | Regras de armazenamento e revogação de chaves no dispositivo. |
As APIs encontram a realidade física na abertura: gateways, portas metálicas e requisitos de bateria determinam se uma chamada API limpa chega a tempo à fechadura. Teste o hardware e o software em conjunto.
| Abertura | Porta típica | Abordagem da fechadura |
|---|---|---|
| Porta de unidade de aluguer | Fechadura Bluetooth com gateway por área | O backend de reservas cria códigos offline e online através da API de cloud. |
| Entrada de vidro de escritórios | Leitor ou controlador online | A plataforma de visitantes envia credenciais de utilização única e recebe webhooks de entrada. |
| Quarto de hóspede de hotel | Fechadura RFID com serviço de chave móvel | O middleware do PMS chama a API de chaves; o gateway transmite atualizações em tempo real. |
| Porta de espaço de cowork | Fechadura inteligente atrás de uma fachada de vidro | A app de membros integra o SDK para desbloqueio nas imediações, mesmo com Wi-Fi fraco. |
| Portão logístico | Fechadura exterior online | Os comandos remotos exigem conectividade confirmada e contactos de contingência. |
| Sala de comodidades | Fechadura a bateria gerida remotamente | Os webhooks registam auditorias de utilização para faturamento e análise de abusividade na app do operador. |
As APIs parecem semelhantes em apresentações e diferem em produção. Antes de afetar tempo de engenharia, os integradores devem recolher os elementos abaixo, dos quais ajudamos a coordenar a obtenção com a equipa da plataforma.
| Componente | Lógica típica | Observações |
|---|---|---|
| Referência da API | Endpoints, âmbitos, versões e disponibilidade do sandbox. | As estimativas de engenharia dependem de documentação completa e atualizada. |
| Pacote SDK | Versões de OS suportadas, apps de exemplo e cadência de lançamento. | É necessário compreender a aprovação pela loja e os modelos de manutenção. |
| Modelo de segurança | Tipos de token, rotação de segredos, assinatura de webhooks e opções de IP. | Proteger os endpoints de desbloqueio é indispensável em produção. |
| Limites e quotas | Limites de caudal, paginação, operações em lote e regras de novas tentativas. | De outro modo, os lançamentos de frotas podem falhar nas horas de ponta de entrada. |
| Catálogo de eventos | Tipos de evento, payloads, ordenação e garantias de reenvio. | As funcionalidades de auditoria e notificação dependem de eventos fiáveis. |
Uma API é uma interface servidor-servidor: o seu backend chama a plataforma de fechaduras via HTTPS para criar códigos, enviar comandos de abertura a fechaduras online, consultar estados e receber eventos de webhook, funcionando independentemente da proximidade do telefone. Um SDK móvel é uma biblioteca de software integrada na sua própria app para iOS ou Android que comunica diretamente com as fechaduras via Bluetooth, permitindo a abertura de fechaduras próximas, a configuração e o armazenamento offline de credenciais quando não há servidor acessível. Os backends de aluguer e as integrações de PMS precisam principalmente da API na cloud; as apps de marca dos inquilinos normalmente precisam do SDK e de chamadas de API selecionadas. Tentar fazer tudo através da API — por exemplo, abrir uma fechadura exclusivamente com Bluetooth do outro lado do mundo sem um gateway — simplesmente não funciona, pelo que a topologia do hardware e a escolha da interface devem ser concebidas em conjunto. As interfaces disponíveis para cada plataforma são confirmadas por escrito em cada cotação.
Sim, esse é um padrão de integração comum: quando uma reserva é confirmada, o seu backend ou middleware chama a API da plataforma de fechaduras com o quarto ou unidade, a data de chegada e de saída, e recebe uma senha ou ekey que é entregue ao hóspede através do seu próprio modelo de mensagem ou email. Os webhooks confirmam depois a utilização e assinalam eventos como tentativas de check-in antecipado ou baterias frágeis. Os requisitos a definir são o tratamento dos fusos horários nas janelas de datas, o tipo de código que funciona offline nas fechaduras selecionadas, a cobertura de gateways para revogação em tempo real, as novas tentativas idempotentes quando as mensagens são reenviadas e a forma como os cancelamentos e alterações de datas atualizam a credencial. Fornecemos fechaduras de teste e apoiamos as sessões de integração; os detalhes dos endpoints, os limites de utilização e as licenciamentos de cada plataforma são confirmados por escrito em cada cotação.
A abertura remota é segura quando a plataforma é concebida como qualquer API financeira autenticada: tokens OAuth com âmbito limitado, armazenamento de segredos do lado do servidor, permissões por Collaborador, confirmação de comandos via webhook, registos de auditoria e aprovação opcional de dois fatores para portas sensíveis. Torna-se perigosa quando os integradores incorporate segredos de longa duração em apps móveis, expõem endpoints de relé abertos ou registam URLs de abertura. As safeguards físicas também são importantes: os comandos remotos apenas chegam a fechaduras online e as portas de alta segurança muitas vezes desativam totalmente a abertura remota ou exigem dupla aprovação. Durante a devida diligência, solicite o whitepaper de segurança, o procedimento de rotação de tokens e o esquema de assinatura de webhooks, em vez de aceitar a alegação de que existe uma “API REST disponível”. Coordenamos estas avaliações com a equipa da plataforma e podemos propor arquiteturas em que a abertura remota fica restrita às funções da receção.
Os webhooks são o canal standard para eventos — registos de aberturas, entradas de códigos, bateria fraca, alertas de adulteração e alterações nos sensores das portas — mas a semântica de entrega varia consoante a plataforma. As plataformas profissionais assinam os payloads, tentam novamente as entregas falhadas com atrasos progressivos e fornecem uma API para reconciliar ou consultar eventos perdidos, o que é importante porque as redes falham temporariamente e a entrega duplicada é normal; por isso, os consumidores devem tratar os IDs de eventos de forma idempotente. As garantias de ordenação são mais fracas: dois eventos gerados com segundos de diferença podem occasionalmente chegar invertidos, pelo que a lógica de auditoria deve usar a data e hora do evento na fechadura em vez da hora de chegada. Durante o piloto, simule um receptor offline e verifique o comportamento de reenvio. O catálogo de eventos, a política de novas tentativas e os endpoints de reconciliação da plataforma são documentados por escrito antes do início do desenvolvimento.
O acesso à API é concedido pela plataforma de fechaduras ao abrigo dos seus próprios termos de desenvolvimento e comerciais, normalmente ao titular da conta: a marca ou o operador que possui o projeto na cloud, e não automaticamente a cada comprador de uma fechadura. A fábrica pode ajudar a ativar o serviço, fornecer documentação e coordenar a integração técnica, mas não pode atribuir direitos para além do acordo da plataforma. Algumas plataformas distinguem utilizadores apenas de app, contas empresariais com dashboards e parceiros de desenvolvimento certificados com acesso total à API, e alguns endpoints avançados exigem uma revisão de integração aprovada. Por isso, os compradores que planeiam integrações profundas devem confirmar a elegibilidade para desenvolvidores, as taxas, os termos de tratamento de dados e as regiões suportadas antes de selecionar o hardware, porque uma excelente fechadura sem direito de acesso à API não pode suportar o produto planeado. Os programas de desenvolvedores e as licenciamentos atuais de cada plataforma são confirmados em cada RFQ.
Partilhe os seus casos de utilização de integração, a stack da equipa e o cronograma de lançamento no seu RFQ. Coordenamos a documentação da API, os pacotes SDK, os dispositivos de teste e os acordos de plataforma, e apoiamos um piloto conjunto que abrange o modo offline, as novas tentativas e os eventos em escala de frota.
Solicitar ficha técnica + cotaçãoVisão geral das tecnologiasÚltima atualização: 31 de outubro de 2026 · Revisado pela equipa editorial da Smart Lock Factory