Risoluzione dei problemi di autenticazione OAuth dell'API

Last updated: October 9, 2026

Per gli errori 500 del server interno e i problemi di autenticazione con l'API Edvisor.

1. Confermare l'endpoint API

Utilizzare solo l'endpoint attuale: https://api-v2.edvisor.io/graphql.

Il precedente endpoint https://api.edvisor.io/graphql è deprecato. Le richieste al vecchio endpoint potrebbero non riuscire o essere bloccate.

2. Controllare l'header Authorization

Deve essere formattato esattamente così: Authorization: Bearer <your_edvisor_api_key>.

Errori comuni:

  • Refusi nel nome dell'header.

  • Mancanza del prefisso Bearer.

  • Spazi aggiuntivi.

3. Verificare la chiave API

  • Confermare che la chiave corrisponda a quella fornita.

  • Controllare che non siano state apportate modifiche accidentali durante l'incollaggio.

  • Richiedere al supporto una chiave rigenerata in caso di dubbi.

4. Impostare il Content-Type corretto

Deve essere: application/json.

È necessario affinché le API Edvisor interpretino i payload.

5. Controllare la presenza di utenti eliminati

Le chiavi API sono associate agli utenti. L'eliminazione degli utenti rende inutilizzabile la chiave API corrispondente. Contattare il supporto per generare una nuova chiave API.

6. Cercare eventuali refusi

Controllare accuratamente tutti gli header e i campi di configurazione. Un piccolo refuso impedisce l'autenticazione.

7. Contattare il supporto

Se tutti i passaggi non hanno esito positivo:

Allegare le risposte di errore o i log. Documentare le modifiche apportate e i codici di errore ricevuti: questo aiuta entrambi i team a risolvere più rapidamente.

Specificare il prodotto o l'endpoint coinvolto (Pagamenti Edvisor, Assicurazione, ecc.) per una risoluzione mirata.