Há duas maneiras de autenticar chamadas para as APIs do HubSpot: OAuth e tokens de acesso a aplicativos privados. Abaixo, saiba mais sobre cada método e como incluí-los em seu código para autorização.
Se você estava usando anteriormente uma chave de API para autenticar, saiba como migrar para o uso de um token de acesso de aplicativo privado.
Observação: as integrações projetadas para uso de vários clientes ou em listagens no Marketplace de aplicativos devem ser criadas como um aplicativo que usa o protocolo OAuth da HubSpot.
Para fazer uma solicitação usando OAuth ao construir um aplicativo público, inclua o token de acesso OAuth no cabeçalho de autorização:
/~curl --header "Authorization: Bearer C4d***sVq"
https://api.hubapi.com/crm/v3/objects/contacts?limit=10&archived=false
Semelhante ao OAuth, para fazer uma solicitação usando um token de acesso a app privado, inclua o token no cabeçalho de autorização:
xxxxxxxxxx
/~curl --header "Authorization: Bearer ***-***-*********-****-****-****-************"
https://api.hubapi.com/crm/v3/objects/contacts?limit=10&archived=false
Para proteger os desenvolvedores de possíveis incidentes de segurança, a HubSpot aproveita os recursos de monitoramento e varredura secreta fornecidos pelo GitHub para detectar quaisquer tokens de autenticação do HubSpot que estejam expostos publicamente nos repositórios do GitHub. Todos os tokens detectados serão desativados automaticamente e você será notificado por e-mail e notificação no aplicativo para que possa gerar um novo token e atualizar suas integrações para substituir o token revogado.
Os tipos de chaves e tokens afetados estão listados abaixo:
- Chaves de API do desenvolvedor criadas dentro da sua conta de desenvolvedor de aplicativo.
- Chaves de acesso pessoal usadas para autenticar comandos no CLI da HubSpot.
- Tokens de acesso privado usados para autenticar solicitações em um aplicativo privado.
- Tokens SMTP usados para envio de e-mails transacionais.
O processo de desativação automática será obrigatório em 7 de abril de 2025. Se você quiser optar por esse recurso proativamente, você pode inscrever sua conta na versão beta seguindo as instruções deste artigo da Central de Conhecimento.