Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Artikel ini mencantumkan pertanyaan yang sering diajukan tentang Microsoft Learn Catalog API, dengan jawaban dan tautannya ke informasi selengkapnya sesuai kebutuhan.
Umum
Q: Berapa biaya untuk menggunakan Learn Catalog API?
Tidak ada biaya untuk menggunakan Learn Catalog API. Untuk informasi selengkapnya, lihat bagian Ketersediaan dan Harga dari artikel gambaran umum fitur Learn Catalog API.
Q: Apa aturan untuk menggunakan Learn Catalog API?
Lihat Microsoft Learn dan Ketentuan Penggunaan Microsoft API .
Q: Apakah saya perlu onboarding atau mendapatkan kunci untuk menggunakan Learn Catalog API?
Tidak. API tersedia untuk umum. Lihat artikel Memulai dengan API Katalog Learn menggunakan cURL dan Visual Studio Code dan/atau artikel Referensi Pengembang API Katalog Learn .
Q: Apakah API ini akan memungkinkan pengguna kami menggunakan konten Learn di dalam platform kami?
Tidak. Learn Catalog API menyediakan metadata tentang konten, dan tautan langsung ke konten. Pengguna dapat mengintegrasikan tautan ini ke dalam Sistem Manajemen Pembelajaran (LMS) atau pengalaman web apa pun sesuai dengan Ketentuan Penggunaan Microsoft API.
Q: Apakah data yang dikembalikan dari Learn Catalog API tetap statis atau berubah?
Data berubah setiap kali konten baru ditambahkan, dimodifikasi, atau dihapus, yang biasanya setiap hari.
Respons API
Q: Dapatkah saya mengambil semua data sekaligus?
Ya. Gunakan titik akhir dasar, learn.microsoft.com/api/catalog untuk mendapatkan respons penuh. Lihat artikel referensi Learn Catalog API Developer untuk informasi permintaan API selengkapnya.
Q: Bisakah saya memfilter respons sebelumnya?
Ya. Lihat filter kueri yang tersedia di artikel Referensi Pengembang Learn Catalog API.
Q: Apakah UID unik untuk setiap objek konten?
Ya. UID adalah singkatan dari "ID Unik" dan unik untuk setiap objek konten. Jika UID berubah, meskipun judul atau metadata lainnya tetap sama, konten dianggap sebagai objek baru.
Q: Mengapa ada tag HTML dalam ringkasan modul?
Kami biasanya mencoba untuk menjaga pemformatan ringkasan setahap mungkin, tetapi kadang-kadang kita perlu menekankan atau menautkan teks tertentu.
Q: Mengapa tidak ada tautan untuk unit individual?
Unit tidak ditulis sebagai entitas mandiri. Mereka dimaksudkan untuk mengikuti urutan tertentu dalam modul. Untuk alasan ini, kami menyertakan tautan ke halaman detail modul dan unit pertama sehingga pengguna dapat mulai di sana dan melanjutkan melalui konten.
Q: Bagaimana cara memberi tahu konten apa yang baru?
Nilai last_modified memberi tahu Anda kapan rekaman terakhir diubah.
Q: Apakah Single Sign-On (SSO) diaktifkan untuk tautan konten?
Tidak saat ini. Kami bertujuan untuk mengaktifkan SSO di masa mendatang.
Konten
Q: Apakah UID unik untuk konten?
Ya. UID adalah singkatan dari "ID Unik" dan unik untuk setiap objek konten. Jika UID berubah, meskipun judul atau metadata lainnya tetap sama, konten dianggap sebagai objek baru.
Q: Apakah semua modul merupakan bagian dari jalur pembelajaran?
Tidak. Semua modul mampu berdiri sendiri, yang berarti bahwa modul tersebut mengajarkan skenario atau konsep secara menyeluruh di dalam modul tersebut dan dapat dipahami tanpa memerlukan modul prasyarat. Bagi sebagian orang, ini sudah cukup dan mereka bukan bagian dari jalur pembelajaran. Bagi yang lain, mereka dibundel bersama-sama dalam satu atau beberapa jalur pembelajaran yang membawa pengguna melalui membangun konsep yang lebih canggih. Modul tidak harus menjadi bagian dari jalur pembelajaran, atau dapat menjadi bagian dari satu atau beberapa modul.
Q: Bagaimana cara mengetahui kapan konten telah ditambahkan, disegarkan, atau dihapus?
Saat objek konten baru ditambahkan, objek tersebut muncul sebagai objek baru (diidentifikasi oleh UID) dalam respons. Saat konten dimodifikasi, Anda dapat mengetahui berdasarkan nilai last_modified. Saat konten dihapus, objek konten dihapus dari respons. Meskipun terkadang ada sedikit keterlambatan pada konten yang diperbarui dalam respons API, ketika pengguna mengikuti URL ke konten, mereka selalu melihat informasi terbaru. Saat konten dihapus, URL lama akan dialihkan ke konten atau pengalaman baru, atau ke opsi terbaik berikutnya.
Terutama, konten sedang diperbarui sepanjang waktu. Kami menerbitkan pembaruan yang tersedia dua kali sehari. Mereka mungkin kecil, seperti perubahan teks kecil, atau utama, seperti revisi utama, penambahan, atau penghapusan. Secara umum, portofolio konten dikelola sebagai proyek sumber terbuka besar dan sangat diatur dengan ribuan kontributor, dan dengan demikian, perubahan terjadi sepanjang waktu. Jika Anda menggunakan Learn Catalog API dalam sistem produksi, Anda harus mengetahui hal ini dan membuat sistem Anda dapat menanganinya.
T: Saya mengikuti tautan yang saya tandai ke konten, tetapi sekarang menampilkan konten yang berbeda dari yang saya harapkan. Mengapa?
Kami berusaha untuk memastikan tidak ada yang mencapai jalan buntu (404) dengan tautan ke situs kami. Ketika konten dimodifikasi atau diganti, kami menerapkan pengalihan untuk tautan lama yang akan secara otomatis membawa Anda ke konten baru. Jika konten dihentikan dan tidak diganti karena berbagai alasan, kami akan mengalihkan ke konten lain yang paling sesuai, yang mungkin memiliki cakupan sedikit berbeda, atau ke halaman arahan, dll.
Q: Bagaimana cara mendapatkan akses ke katalog sampel dokumentasi, video, dan kode?
Saat ini tidak ada cara terprogram untuk mendapatkan akses ke katalog ini. Kami bertujuan untuk mengaktifkan akses terprogram ke katalog ini di masa mendatang.
Lokalisasi
Q: Bahasa apa yang tersedia di Microsoft Learn?
Ada lebih dari 65 lokal yang tersedia di Microsoft Learn. Anda dapat melihat daftar lengkap di sini melalui footer situs (pilih bahasa yang Anda lihat untuk melihat daftar lengkap).
Q: Apakah konten tersedia dalam bahasa lain?
Itu tergantung. Kami bertujuan untuk menyediakan konten dalam semua bahasa di mana produk yang diajarkan dalam konten tersebut tersedia. Saat pelajar mengunjungi situs Microsoft Learn di lokal tertentu, jika konten tidak tersedia di lokal tersebut, pengguna akan melihat header dan footer di lokal yang diinginkan, dan konten inti default kembali ke bahasa Inggris hingga versi yang dilokalkan tersedia.
Q: Apakah konten berbeda untuk objek konten tertentu, tergantung pada bahasa apa Anda melihatnya?
Mungkin. Ketika pembaruan diterbitkan ke konten bahasa Inggris, alur pelokalan kami berfungsi untuk memperbarui versi yang dilokalkan sesegera mungkin - biasanya dalam beberapa hari setelah perubahan asli.
Lain
Q: Apakah ada API pelaporan atau fungsionalitas untuk mendapatkan data seperti tampilan, klik, penyelesaian?
Saat ini kami tidak memiliki API pelaporan. Kami memiliki fungsionalitas laporan organisasi yang memungkinkan organisasi untuk melaporkan penyelesaian oleh pengguna mereka.
Langkah berikutnya
Anda dapat mempelajari selengkapnya tentang Learn Catalog API dengan mengunjungi tautan berikut: