Come eseguire il debug delle chiamate api Microsoft Graph

È possibile compilare un'applicazione che usa le API Microsoft Graph per connettersi a Microsoft 365 e scoprire che l'API non funziona come previsto. Come si esegue il debug? Questo articolo condivide alcune raccomandazioni per il debug delle chiamate all'API Microsoft Graph.

Verificare la presenza di problemi noti

Prima di avviare il debug, verificare se il problema riscontrato è un problema noto con l'API Microsoft Graph. Per altre informazioni, vedere il sito Web dei problemi noti di Microsoft Graph.

Controllare il log delle modifiche

Se si usa l'endpoint beta di Microsoft Graph, controllare il log delle modifiche di Microsoft Graph per eventuali modifiche che potrebbero influire sull'applicazione. Il log delle modifiche contiene informazioni su nuove funzionalità, modifiche e correzioni nell'API Microsoft Graph. Contiene anche informazioni sulle modifiche importanti che potrebbero influire sulla tua applicazione.

Controllare la documentazione

Quando l'API non funziona come previsto, controllarne la documentazione. Può contenere informazioni che consentono di comprendere il problema riscontrato. Ad esempio, la documentazione potrebbe contenere informazioni su limitazioni note, requisiti specifici o altre considerazioni.

Controllare i limiti di limitazione

Controllare i limiti di limitazione per l'API in uso. Se si superano i limiti di limitazione , l'API potrebbe restituire un codice di stato HTTP 429 (Too Many Requests) . Se la tua applicazione viene rallentata, gestiscila correttamente nell'applicazione.

Gestire gli errori previsti

Microsoft Graph usa codici di stato HTTP standard per comunicare i relativi errori. Per altre informazioni sui codici di stato restituiti dall'API Microsoft Graph, vedere Risposte agli errori e tipi di risorse di Microsoft Graph.

Generare e registrare un id client-request-id univoco

In ogni richiesta a Microsoft Graph generare un GUID univoco, inviarlo nell'intestazione della client-request-id richiesta HTTP e registrarlo nei log dell'applicazione. Queste informazioni consentono di tenere traccia e correlare richieste e risposte durante il debug dei problemi. Consente inoltre al supporto tecnico di Microsoft di diagnosticare il problema se è necessario segnalarlo.

Registrare l'ID della richiesta e la data dalle intestazioni HTTP di risposta

Registra sempre l'ID della richiesta e la data dalle intestazioni della risposta HTTP. Insieme all'intestazione client-request-id , sono necessari quando si segnalano problemi in Microsoft Q&A o al supporto tecnico Microsoft. Senza queste intestazioni, la diagnosi del problema è difficile.

Usare Dev Proxy per verificare se l'applicazione aggiunge l'intestazione client-request-id della richiesta HTTP alle richieste inviate a Microsoft Graph.

Passo successivo

Controllare se l'app usa l'intestazione client-request-id