Cara mendiagnosis panggilan API Microsoft Graph

Anda mungkin membuat aplikasi yang menggunakan API Microsoft Graph untuk menyambungkan ke Microsoft 365 dan menemukan bahwa API tidak berfungsi seperti yang Anda harapkan. Bagaimana Anda men-debugnya? Artikel ini membagikan beberapa rekomendasi untuk memecahkan masalah panggilan ke Microsoft Graph API.

Memeriksa masalah yang diketahui

Sebelum mulai memecahkan masalah, periksa apakah masalah yang Anda hadapi adalah masalah yang sudah diketahui dengan Microsoft Graph API. Untuk informasi selengkapnya, lihat website masalah yang telah diketahui Microsoft Graph.

Periksa catatan perubahan

Jika Anda menggunakan titik akhir beta Microsoft Graph, periksa changelog Microsoft Graph untuk setiap perubahan yang mungkin memengaruhi aplikasi Anda. Changelog berisi informasi tentang fitur, perubahan, dan perbaikan baru di Microsoft Graph API. Ini juga berisi informasi tentang perubahan besar yang mungkin memengaruhi aplikasi Anda.

Periksa dokumentasi

Saat API tidak berfungsi seperti yang diharapkan, periksa dokumentasinya. Ini mungkin berisi informasi yang dapat membantu Anda memahami masalah yang Anda hadapi. Misalnya, dokumentasi mungkin berisi informasi tentang batasan yang diketahui, persyaratan tertentu, atau pertimbangan lainnya.

Periksa batas pembatasan

Periksa batas kecepatan untuk API yang Anda gunakan. Jika Anda melebihi batas throttling, API mungkin mengembalikan kode status HTTP 429 (Too Many Requests). Jika Anda dibatasi, tangani dengan benar di aplikasi Anda.

Menangani kesalahan yang diharapkan

Microsoft Graph menggunakan kode status HTTP standar untuk mengomunikasikan kesalahannya. Untuk informasi selengkapnya tentang kode status yang dikembalikan MICROSOFT Graph API, lihat Respons kesalahan Microsoft Graph dan jenis sumber daya.

Membuat dan mencatat id permintaan klien yang unik

Pada setiap permintaan ke Microsoft Graph, buat GUID unik, kirim di client-request-id header permintaan HTTP, dan catat di log aplikasi Anda. Informasi ini membantu Anda melacak dan menghubungkan permintaan dan respons saat Anda men-debug masalah. Ini juga membantu Dukungan Microsoft untuk mendiagnosis masalah jika Anda perlu melaporkannya.

Mencatat ID permintaan dan tanggal dari header respons HTTP

Selalu catat ID permintaan dan tanggal dari header respons HTTP. Bersama dengan header client-request-id, keduanya diperlukan saat Anda melaporkan masalah di Microsoft Q&A atau ke Dukungan Microsoft. Tanpa header ini, mendiagnosis masalahnya sulit.

Gunakan Dev Proxy untuk melihat apakah aplikasi Anda menambahkan client-request-id header permintaan HTTP ke permintaan yang dikirimnya ke Microsoft Graph.

Langkah selanjutnya