Se você estiver com problemas com suas chaves API, como falhas em chamadas API, desativações inesperadas ou e-mails de segurança, revise as seguintes dicas antes de entrar em contato com nossa equipo de suporte.
Eu recebo um erro "Access denied for resource" (Acesso negado ao recurso)
Uma chamada API falha e a resposta diz que a chave API não inclui a permissão necessária. A mensagem é semelhante a Access denied for resource "account". The API key does not include the required permission. Update the key permissions or send the request with a different key. (Acesso negado ao recurso "conta". A chave da API não inclui a permissão necessária. Atualize as permissões da chave ou envie a solicitação com uma chave diferente.) O nome do recurso muda dependendo da chamada.
Causas e soluções comuns
Expanda os itens a seguir para saber mais sobre cada causa:
O recurso nomeado no erro é um recurso que a chave não pode alcançar ou não pode usar da maneira que a chamada exige. Por exemplo, uma chave com permissão Read (Ler) pode ver um recurso, mas não pode alterá-lo, e excluir requer permissão All (Tudo). Isso também pode acontecer se as permissões da chave foram reduzidas quando ela foi editada.
Solução: Edite a chave e defina o nível de permissão que a chamada precisa para esse recurso. Para saber mais, consulte nosso artigo dedicado Criar e gerenciar suas chaves API. Apenas o proprietário da conta ou usuários com permissão de chaves API podem editar uma chave.
Se a sua conta tem várias chaves API, a integração pode estar usando uma chave cujas permissões não incluem o recurso.
Solução: Compare os últimos dígitos da chave que sua integração usa com aqueles exibidos na página API Keys & MCP (Chaves API e MCP). Em seguida, atualize as permissões dessa chave ou altere a integração para uma chave que tenha a permissão necessária.
Verifique a correção
Envie a mesma chamada API novamente com a chave atualizada e verifique se ela não retorna mais o erro.
Se o problema persistir, entre em contato com nossa equipe de suporte e inclua os últimos dígitos da chave e a mensagem de erro exata que você recebeu.
Minha chave API mostra "No fixed date" (Sem data fixa), mas recebi um aviso de inatividade
Você não definiu uma data de expiração ao criar sua chave API, mas ainda assim recebeu um aviso por e-mail de que a chave será desativada por inatividade.
Causa e solução
A data de expiração e a regra de inatividade são duas configurações separadas. No expiration (Sem expiração) significa apenas que a chave não tem uma data de expiração fixa. Qualquer chave que não tenha feito uma chamada API bem-sucedida em 90 dias será desativada, independentemente de sua configuração de expiração.
Solução: confirme que sua integração usa essa chave específica, pois pode usar uma chave diferente da sua conta. Então, verifique se ele faz pelo menos uma chamada API bem-sucedida antes que os 90 dias terminem. Se a chave já estiver desativada, você poderá reativá-la. Para saber mais, consulte nosso artigo dedicado Criar e gerenciar suas chaves API.
Verifique a correção
Faça um teste de chamada API com a chave API e verifique na página API Keys & MCP (Chaves API e MCP) se o status dela é ativo e se Last used on (Último uso em) mostra a data de hoje.
Se o problema persistir, entre em contato com nossa equipe de suporte e inclua os últimos dígitos da chave e a mensagem de aviso exata que você recebeu.
Recebi um e-mail de segurança "Verificar um novo IP"
Você recebeu um e-mail da Brevo pedindo para confirmar ou negar uma chamada API feita de um endereço IP não reconhecido, e você não tem certeza se é legítimo.
Causa e solução
Se o bloqueio de endereços IP desconhecidos estiver ativado na sua conta, a Brevo enviará este e-mail sempre que detectar uma chamada API de um endereço IP que não foi usado antes. Isso não significa necessariamente que algo está errado. Uma integração legítima, como um novo servidor ou ferramenta de terceiros, pode ser um gatilho para ele quando se conecta pela primeira vez.
Solução: se você reconhecer a atividade, autorize o novo endereço IP a partir do e-mail ou da página de IPs autorizados. Se você não reconhecer, negue-a e exclua a chave API afetada imediatamente, depois crie uma nova. Para saber mais, consulte nosso artigo dedicado Autorizar e bloquear endereços IP para segurança de API e SMTP.
Verifique a correção
Acesse a página de Authorized IPs (IPs autorizados) e confirme se o endereço IP exibe o status esperado, autorizado ou removido.
Se você continuar recebendo alertas de endereços IP que não reconhece após substituir sua chave API, entre em contato com nossa equipe de suporte.
⏭️ O que vem a seguir?
- Criar e gerenciar suas chaves API
- Sobre as permissões de chave API
- Minha conta foi comprometida, o que devo fazer?
🤔 Dúvidas?
Em caso de dúvida, sinta-se à vontade para entrar em contato com nossa equipe de suporte, criando um tíquete a partir da sua conta. Caso ainda não tenha uma conta, entre em contato conosco aqui.
Se você está procurando ajuda com um projeto usando o Brevo, podemos encontrar à agência parceira da Brevo certa.