Berkembang dengan REST API untuk Power BI Report Server

Power BI Report Server mendukung API Representational State Transfer (REST). REST API adalah titik akhir layanan yang mendukung serangkaian operasi HTTP (metode), yang menyediakan akses buat, ambil, perbarui, atau hapus untuk sumber daya dalam server laporan.

REST API menyediakan akses terprogram ke objek dalam katalog Power BI Report Server. Contoh objek adalah folder, laporan, KPI, sumber data, himpunan data, paket refresh, langganan, dan lainnya. Dengan menggunakan REST API, Anda dapat, misalnya, menavigasi hierarki folder, menemukan konten folder, atau mengunduh definisi laporan. Anda juga dapat membuat, memperbarui, dan menghapus objek. Contoh bekerja dengan objek adalah mengunggah laporan, menjalankan rencana refresh, menghapus folder, dan sebagainya.

Catatan

Jika Anda tertarik untuk melihat atau menghapus data pribadi, silakan tinjau panduan Microsoft di Windows Permintaan Subjek Data untuk situs GDPR. Jika Anda mencari informasi umum terkait GDPR, lihat bagian GDPR dari Microsoft Service Trust Portal.

Komponen permintaan/respon dari REST API

Pasangan permintaan/respons REST API dapat dipisahkan menjadi lima komponen:

  • Permintaan URI, yang terdiri atas: {URI-scheme} :// {URI-host} / {resource-path} ? {query-string}. Meskipun URI permintaan disertakan dalam header pesan permintaan, kami menyebutnya secara terpisah di sini karena sebagian besar bahasa atau kerangka kerja mengharuskan Anda untuk meneruskannya secara terpisah dari pesan permintaan.

    • Skema URI: Menunjukkan protokol yang digunakan untuk mengirimkan permintaan. Misalnya, http atau https.
    • Host URI: menentukan nama domain atau alamat IP server tempat titik akhir layanan REST dihosting, seperti myserver.contoso.com.
    • Jalur sumber daya: menentukan sumber daya atau koleksi sumber daya, yang mungkin menyertakan beberapa segmen yang digunakan oleh layanan dalam menentukan pemilihan sumber daya tersebut. Misalnya: CatalogItems(01234567-89ab-cdef-0123-456789abcdef)/Properties dapat digunakan untuk mendapatkan properti yang ditentukan untuk CatalogItem.
    • String query (opsional): menyediakan parameter sederhana tambahan, seperti versi API atau kriteria pemilihan sumber daya.
  • Bidang header pesan permintaan HTTP:

    • Metode HTTP yang diperlukan (juga dikenal sebagai operasi atau kata kerja), yang memberi tahu layanan jenis operasi apa yang Anda minta. Layanan Laporan API REST mendukung metode DELETE, GET, HEAD, PUT, POST, dan PATCH.
    • Bidang header tambahan opsional, sebagaimana diperlukan oleh metode URI dan HTTP yang ditentukan.
  • Bidang isi pesan permintaan HTTP opsional, untuk mendukung operasi URI dan HTTP. Misalnya, operasi POST berisi objek yang dikodekan MIME yang diteruskan sebagai parameter kompleks. Untuk operasi POST atau PUT, jenis pengodean MIME untuk isi juga harus ditentukan di header permintaan Content-type juga. Beberapa layanan mengharuskan Anda menggunakan jenis MIME tertentu, seperti application/json.

  • Bidang header pesan respons HTTP:

    • Kode status HTTP, mulai dari 2xx kode keberhasilan hingga 4xx atau 5xx kode kesalahan. Alternatifnya, kode status yang ditentukan layanan dapat dikembalikan, seperti yang ditunjukkan dalam dokumentasi API.
    • Bidang header tambahan opsional, sebagaimana diperlukan untuk mendukung respons permintaan, seperti Content-type header respons.
  • Bidang isi pesan respons HTTP opsional:

    • Objek respons yang dikodekan MIME dikembalikan dalam isi respons HTTP, seperti respons dari metode GET yang mengembalikan data. Biasanya, objek ini dikembalikan dalam format terstruktur seperti JSON atau XML, seperti yang ditunjukkan oleh Content-type header respons.

Dokumentasi API

REST API modern memanggil dokumentasi API modern. REST API dibangun berdasarkan spesifikasi OpenAPI (alias spesifikasi swagger) dan dokumentasi tersedia di Microsoft Learn.

Menguji panggilan API

Alat untuk menguji pesan permintaan/respons HTTP adalah Fiddler. Fiddler adalah proksi penelusuran kesalahan web gratis yang dapat mencegat permintaan REST Anda, sehingga mudah untuk mendiagnosis pesan permintaan/respons HTTP.

Tinjau API yang tersedia di Microsoft Learn.

Sampel tersedia di GitHub. Sampel mencakup aplikasi HTML5 yang dibangun di TypeScript, React, dan webpack bersama dengan contoh PowerShell.

Ada pertanyaan lagi? Coba tanyakan kepada Komunitas Power BI