Ultima atualização: Novembro 24, 2021
Com a chave de API da HubSpot, seus desenvolvedores podem criar aplicativos personalizados com APIs da HubSpot. Cada chave é específica para uma conta da HubSpot, não para um usuário individual, e apenas uma chave é permitida por vez.
Observação: se quiser criar vários aplicativos ou um controle mais granular sobre os escopos do aplicativo, poderá criar um aplicativo privado, em vez de usar uma única chave de API em todos os aplicativos. Cada aplicativo privado tem seu próprio token de acesso, que é implementado além do OAuth. Saiba mais sobre aplicativos privados na documentação para desenvolvedores da HubSpot.
Acessar sua chave de API
Você deve ter permissões de Superadministrador para acessar a chave de API da sua conta.
- Na sua conta da HubSpot, clique no ícone de configurações na barra de navegação principal.
- No menu da barra lateral esquerda, acesse Integrações > Chave de API.
- Se uma chave nunca tiver sido gerada para sua conta, clique em Gerar chave de API.
- Se já tiver gerado uma chave de API, clique em Mostrar para exibir sua chave.
- Com a chave exibida, clique em Copiar para copiar a chave. Você pode colar a chave para fornecê-la aos desenvolvedores ou usá-la em seus aplicativos.
Revezar sua chave de API
Fornecer a chave de API para um desenvolvedor concederá o acesso completo para fazer alterações na sua conta por meio da API da HubSpot, incluindo ler e-mails registrados das contas de e-mail conectadas e outros dados de terceiros.
Para segurança adicional, considere alterar a chave de API da HubSpot a cada seis meses. Ao alterar sua chave de API da HubSpot, a chave existente será ativada e uma nova será gerada. A HubSpot exibirá a idade da chave de API e recomendará quando você deve alterá-la.
Lembretes para alterar a chave de API serão enviados aos Superadministradores e aos usuários que criaram ou alteraram a chave de API nas seguintes frequências e tipos de notificação:
- Quando a chave de API fizer cinco meses, as notificações de e-mail serão enviadas.
- Quando a chave de API fizer seis meses, as notificações da barra lateral serão enviadas.
- Se a chave de API não for alterada em seis meses, as notificações de e-mail e da barra lateral serão enviadas a cada seis meses.
Embora isso possa criar tempo de inatividade e exigir esforço, adiciona uma camada de segurança, impedindo que aplicativos mal intencionados acessem suas informações da HubSpot usando a chave de API existente.
Para alterar a chave de API da HubSpot:
- Na sua conta da HubSpot, clique no ícone de configurações na barra de navegação principal.
- No menu da barra lateral esquerda, acesse Integrações > Chave de API.
- Clique no menu suspenso Ações e selecione Alterar a chave.
- Clique em Alterar e expirar essa chave agora. Marque a caixa de seleção de reCAPTCHA. Sua chave existente será desativada e uma nova chave de API será criada.
- Clique em Copiar e substitua a chave de API desativada usada pelos aplicativos por essa nova chave de API.
As chamadas de API que usam essa chave de API da HubSpot falharão e os aplicativos que usam essa chave não poderão mais acessar suas informações.
Alterar a chave de API não afetará sua conexão com a integração do Salesforce. No entanto, se você tiver uma integração personalizada instalada, será necessário atualizar sua chave de API após alterná-la.
Observação: Os aplicativos conectados instalados por meio do Marketplace de aplicativos não serão afetados ao alterar a chave de API.
Desativar sua chave de API
Desativar a chave de API não criará uma nova chave. Ocorrerão falhas nas chamadas de API usando a chave de API da HubSpot desativada e qualquer aplicativo que usa a chave não poderá mais acessar suas informações.
Para desativar a chave de API:- Na sua conta da HubSpot, clique no ícone de configurações na barra de navegação principal.
- No menu da barra lateral esquerda, acesse Integrações > Chave de API.
- Clique no menu suspenso Ações.
- Clique em Desativar chave e, em seguida, em Desativar esta chave agora. Marque a caixa de seleção de reCAPTCHA.
Exibir seu registro de auditoria de API
Veja um registro datado dos usuários que visualizaram, criaram ou desativaram a chave de API da conta na seção Registro de auditoria.
- Na sua conta da HubSpot, clique no ícone de configurações na barra de navegação principal.
- No menu da barra lateral esquerda, acesse Integrações > Chave de API.
- Clique na guia Registro de auditoria.
Exibir o registro de chamadas da chave de API
Para ajudar a depurar uma de suas integrações ou garantir que você esteja em conformidade com asDiretrizes de uso de APIs da HubSpot, você pode visualizar um registro das chamadas da chave de API dos últimos sete (7) dias.
- Na sua conta da HubSpot, clique no ícone de configurações na barra de navegação principal.
- No menu da barra lateral esquerda, acesse Integrações > Chave de API.
- Na guia Registro de chamadas, visualize todas as atividades dos últimos sete (7) dias.
