Resoluçã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

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

O endpoint anterior https://api.edvisor.io/graphql está obsoleto. Os pedidos para o endpoint antigo podem falhar ou ser bloqueados.

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 extra.

3. Verifique a chave da API

  • Confirme que a chave corresponde à que lhe foi fornecida.
  • Verifique se não ocorreram alterações acidentais durante a colagem.
  • Se não tiver a certeza, solicite uma nova chave ao suporte.

4. Defina o Content-Type correto

Deve ser: application/json.

É necessário para que as APIs Edvisor interpretem os dados enviados.

5. Verifique se existem utilizadores eliminados

As chaves da API estão associadas a utilizadores. A eliminação de utilizadores invalida a chave da API correspondente. Contacte o suporte para gerar uma nova chave da API.

6. Procure 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. Contacte o suporte

Se todos os passos falharem:

Anexe respostas de erro ou registos. Documente as alterações efetuadas e os códigos de erro recebidos — isto ajuda ambas as equipas a resolver o problema mais rapidamente.

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