Dados impulsionam experiências unificadas conectadas. À medida que a sofisticação do que você cria cresce, também aumenta a necessidade de maneiras fáceis de usar, mas seguras para acessar esses dados. Anteriormente, o método de integração 1: 1 da HubSpot era uma única chave de API, conhecida como chave HAPI.
O problema com as chaves HAPI
As chaves de API da HubSpot funcionaram bem, mas tiveram um custo. A única maneira de conectar uma integração personalizada a uma conta HubSpot era usar a chave API da conta. Todas as integrações compartilham a mesma chave, o que significa que todas as solicitações de API para todas as integrações são agrupadas para limites e monitoramento. Isso também significa que, se a chave precisar ser girada, ela precisará ser substituída em cada integração separadamente. As Chaves de API da HubSpot também concedem acesso completo aos dados em uma conta da HubSpot.
Em essência, é como ter a mesma chave para todos os quartos de um hotel. Os hóspedes ficariam desconfortáveis sabendo que outros hóspedes poderiam entrar em seus quartos e, se uma fechadura quebrasse, todas as chaves precisariam ser trocadas. Obviamente, esta solução não é ideal.
Apps privados para o resgate!
Até agora, os desenvolvedores que fazem chamadas de API HubSpot em casos de uso
1: 1 tinham que escolher entre a facilidade de uso de chaves de API e a segurança e controle de OAuth.
Para tornar seus portais mais seguros e sua solução de problemas menos complicada, estamos lançando aplicativos privados, uma maneira mais segura e mais amigável para os desenvolvedores criarem integrações personalizadas com a API HubSpot. Embora as chaves de API ainda tenham suporte, os aplicativos privados oferecem melhorias de segurança e usabilidade que os clientes têm pedido.
Os aplicativos privados permitem que os desenvolvedores configurem um token de acesso estático separado para cada integração. Cada integração terá seu próprio registro de chamadas de API, permitindo que você visualize as solicitações de API para uma única integração. Isso também permite que você gire o token para uma única integração sem afetar suas outras integrações e tornamos a rotação do token de acesso mais fácil, oferecendo suporte a dois tokens válidos de uma vez por aplicativo privado. Os tokens de acesso de aplicativo privado também têm como escopo os tokens de acesso OAuth, para que você possa controlar o acesso de cada integração à sua conta HubSpot.
Como funcionam os aplicativos privados
Para construir um aplicativo privado, clique no ícone de configurações em sua conta HubSpot e escolha integrações> Aplicativos privados. Clique em “Criar aplicativo privado”. Na guia Informações básicas, você pode nomear seu aplicativo, carregar um ícone e adicionar uma descrição.
A guia Escopos " Scopes tab " é onde você configurará os escopos e recursos do aplicativo. Procure o escopo que você deseja que seu aplicativo privado acesse na barra de pesquisa e selecione a caixa de seleção “Gravar”, “Ler” ou “Solicitar” ao lado dos escopos desejados.
Clique em “Criar aplicativo” no canto superior direito, revise o token de acesso e, voila! Agora você criou um aplicativo privado. Depois de criado, você pode começar a fazer chamadas de API usando o token de acesso do aplicativo. E como os aplicativos privados são sempre fáceis de usar, você pode editar seu aplicativo a qualquer momento sem afetar suas outras conexões de API.
Se quiser saber mais, veja nossa documentação do desenvolvedor aqui