Como depurar chamadas de API do Microsoft Graph

Você pode criar um aplicativo que usa APIs do Microsoft Graph para se conectar ao Microsoft 365 e descobrir que a API não está funcionando como esperado. Como é que o depuras? Este artigo compartilha algumas recomendações para depurar chamadas de API do Microsoft Graph.

Verificar problemas conhecidos

Antes de começar a depuração, verifique se o problema que você está enfrentando é um problema conhecido com a API do Microsoft Graph. Para obter mais informações, consulte o site de problemas conhecidos do Microsoft Graph.

Verifique o registo de alterações

Se estiver a usar o ponto de extremidade beta do Microsoft Graph, verifique o registo de alterações do Microsoft Graph para quaisquer alterações que possam afetar a sua aplicação. O changelog contém informações sobre novos recursos, alterações e correções na API do Microsoft Graph. Ele também contém informações sobre alterações significativas que podem afetar seu aplicativo.

Consulte a documentação

Quando a API não estiver funcionando conforme o esperado, verifique sua documentação. Ele pode conter informações que podem ajudá-lo a entender o problema que você está enfrentando. Por exemplo, a documentação pode conter informações sobre limitações conhecidas, requisitos específicos ou outras considerações.

Verifique os limites de limitação

Verifique os limites de limitação para a API que você está usando. Se você exceder os limites de limitação , a API poderá retornar um código de status HTTP 429 (Too Many Requests) . Se fores limitado, trate-o corretamente na tua aplicação.

Lidar com erros esperados

O Microsoft Graph usa códigos de status HTTP padrão para comunicar seus erros. Para obter mais informações sobre códigos de status que as APIs do Microsoft Graph retornam, consulte Respostas de erro e tipos de recursos do Microsoft Graph.

Gerar e registrar um ID de solicitação de cliente exclusivo

Em cada solicitação ao Microsoft Graph, gere um GUID exclusivo, envie-o no cabeçalho da client-request-id solicitação HTTP e registre-o nos logs do seu aplicativo. Essas informações ajudam você a rastrear e correlacionar solicitações e respostas ao depurar problemas. Ele também ajuda o Suporte da Microsoft a diagnosticar o problema, se você precisar denunciá-lo.

Registre a ID da solicitação e a data dos cabeçalhos de resposta HTTP

Sempre registre a ID e a data da solicitação nos cabeçalhos de resposta HTTP. Juntamente com o client-request-id cabeçalho, eles são necessários quando você relata problemas nas Perguntas e Respostas da Microsoft ou ao Suporte da Microsoft. Sem esses cabeçalhos, o diagnóstico do problema é difícil.

Use o Dev Proxy para ver se seu aplicativo adiciona o cabeçalho de client-request-id solicitação HTTP às solicitações que ele envia ao Microsoft Graph.

Próximo passo