Solução de problemas de erros de autenticação OAuth da API

Last updated: October 9, 2026

Para erros internos do servidor 500 e problemas de autenticação com a API Edvisor.

1. Confirme o endpoint da API

Use apenas o endpoint atual: https://api-v2.edvisor.io/graphql.

O endpoint anterior https://api.edvisor.io/graphql está obsoleto. As solicitações ao endpoint antigo podem falhar ou ser bloqueadas.

2. Verifique o cabeçalho de autorização

Deve ser formatado exatamente assim: Authorization: Bearer <your_edvisor_api_key>.

Erros comuns:

  • Erros de digitação no nome do cabeçalho.
  • Ausência do prefixo Bearer.
  • Espaços extras.

3. Verifique a chave da API

  • Confirme se a chave corresponde à fornecida.
  • Verifique se houve modificações acidentais durante a colagem.
  • Solicite uma nova chave à equipe de suporte se não tiver certeza.

4. Defina o Content-Type correto

Deve ser: application/json.

É obrigatório para que as APIs da Edvisor interpretem os payloads.

5. Verifique se há usuários excluídos

As chaves da API estão vinculadas aos usuários. Usuários excluídos invalidam a chave da API correspondente. Entre em contato com o suporte para gerar uma nova chave da API.

6. Procure por erros de digitação

Verifique cuidadosamente todos os cabeçalhos e campos de configuração. Um pequeno erro de digitação impede a autenticação.

7. Entre em contato com o suporte

Se todas as etapas falharem:

Anexe as respostas de erro ou os logs. Documente as alterações realizadas e os códigos de erro recebidos — isso ajuda ambas as equipes a resolver o problema mais rapidamente.

Especifique o produto ou endpoint envolvido (Edvisor Pagamentos, Seguros, etc.) para uma resolução direcionada.