Ikhtisar API Web portal
Catatan
Mulai 12 Oktober 2022, portal Power Apps menjadi Power Pages. Informasi selengkapnya: Microsoft Power Pages kini tersedia secara umum (blog)
Kami akan segera memigrasikan dan menggabungkan dokumentasi portal Power Apps dengan dokumentasi Power Pages.
API web portal memungkinkan untuk pengalaman pengguna yang lebih kaya dalam halaman portal Power Apps. Anda dapat menggunakan API Web untuk melakukan operasi buat, baca, perbarui, dan hapus di semua tabel Microsoft Dataverse dari halaman portal Anda. Contohnya, Anda dapat membuat akun baru, memperbarui kontak, atau mengubah izin tabel untuk produk dengan menggunakan API Web portal, bukan aplikasi Portal Management.
Catatan
Anda juga dapat menggunakan API web portal di Power Pages. Informasi selengkapnya, Apa itu Power Pages
Penting
- Versi portal Anda harus 9.3.3.x atau versi yang lebih baru agar fitur ini berfungsi.
- API web portal dibuat untuk membuat pengalaman pengguna yang lebih kaya dalam halaman portal. Tidak dioptimalkan untuk layanan pihak ketiga atau integrasi aplikasi. Menggunakan API Web portal untuk diintegrasikan dengan situs portal Power Apps lain juga tidak didukung.
- Operasi API Web portal terbatas ke tabel yang terkait dengan data—misalnya, akun, kontak, atau tabel kustom Anda. Mengkonfigurasi metadata tabel atau data tabel konfigurasi portal—misalnya, mengkonfigurasi tabel portal seperti adx_contentsnippet, adx_entityform, atau adx_entitylist—tidak didukung dengan API Web portal. Untuk daftar lengkap, buka tabel konfigurasi yang tidak didukung, nanti di topik ini.
- API web portal mendapatkan keuntungan dari caching sisi server sehingga panggilan berikutnya ke web api lebih cepat daripada panggilan awal. Perhatikan bahwa membersihkan cache sisi server portal menyebabkan penurunan kinerja sementara.
- Operasi Web API portal memerlukan lisensi portal Power Apps. Misalnya, panggilan Web API yang dilakukan oleh pengguna anonim dihitung terhadap kapasitas tampilan halaman. Panggilan API Web yang dilakukan oleh pengguna terotentikasi (internal atau eksternal) tidak dihitung terhadap tampilan halaman, namun memerlukan lisensi yang berlaku. Informasi selengkapnya: Tanya Jawab lisensi portal Power Apps
Operasi Web API
API web portal menawarkan subset kemampuan untuk operasi Dataverse yang dapat Anda lakukan menggunakan API Dataverse. Kami telah menyimpan format API seserupa mungkin, untuk mengurangi kurva pembelajaran.
Catatan
Operasi web API peka huruf besar/kecil.
Operasi API web tersedia di portal
- Membaca rekaman dari tabel
- Membuat rekaman dalam tabel
- Memperbarui dan menghapus rekaman dalam tabel
- Mengaitkan dan memisahkan tabel
Pengaturan situs untuk web API
Anda harus mengaktifkan pengaturan lokasi untuk mengaktifkan portal web API untuk portal Anda. Anda juga dapat mengkonfigurasi API Web tingkat bidang yang menentukan bidang tabel yang dapat atau tidak dapat dimodifikasi dengan API Web portal.
Catatan
Gunakan nama logika tabel untuk pengaturan ini (misalnya akun).
| Nama Pengaturan Situs | Description |
|---|---|
| Webapi/<table name>/enabled | Mengaktifkan atau menonaktifkan web API untuk <table name>. Default: False Nilai valid: True, False |
| Webapi/<table name>/fields | Menentukan daftar atribut yang dipisahkan koma yang dapat dimodifikasi dengan web API. Nilai yang mungkin: - Semua atribut: * - Atribut tertentu: attr1,attr2,attr3 Catatan: nilai harus berupa tanda bintang (*) atau daftar nama bidang yang dipisahkan koma. Penting: Ini adalah pengaturan situs wajib. Bila pengaturan ini tidak ada, Anda akan melihat kesalahan "tidak ada bidang yang ditentukan untuk entitas ini". |
| Webapi/error/innererror | Mengaktifkan atau menonaktifkan InnerError. Default: False Nilai valid: True, False |
| Webapi/<table name>/disableodatafilter | Mengaktifkan atau menonaktifkan file OData. Default: False Nilai yang valid: True, Falselihat masalah yang diketahui untuk aktivitas. Pengaturan situs tersedia di versi portal 9.4.10.74 atau yang lebih baru. |
Catatan
Pengaturan situs harus diatur ke aktif agar perubahan diterapkan.
Contohnya, untuk mengekspos API Web untuk tabel Kasus di mana pengguna terotentikasi diizinkan untuk melakukan operasi pembuatan, pembaruan, dan penghapusan pada entitas ini, pengaturan situs ditampilkan dalam tabel berikut.
| Nama Pengaturan Situs | Nilai pengaturan Situs |
|---|---|
| Webapi/incident/enabled | true |
| Webapi/incident/fields | attr1, attr2, attr3 |
Keamanan dengan API web portal
Anda dapat mengkonfigurasi keamanan berbasis rekaman ke rekaman individual di portal menggunakan izin tabel. API Web portal mengakses rekaman (entitas) dan mengikuti izin tabel yang diberikan kepada pengguna melalui peran web terkait.
Anda dapat mengkonfigurasi izin kolom untuk menentukan lebih lanjut hak istimewa ke masing-masing kolom dalam tabel saat menggunakan API Web portal.
Mengautentikasi permintaan API web portal
Anda tidak perlu menyertakan kode otentikasi, karena autentikasi dan otorisasi dikelola oleh sesi aplikasi. Semua panggilan API web harus mencakup token permintaan pemalsuan permintaan lintas situs (CSRF).
menggunakan EntitySetName
Bila merujuk ke tabel Dataverse menggunakan API Web portal di kode Anda, Anda harus menggunakan EntitySetName, contohnya,untuk mengakses tabel akun, sintaks kode akan menggunakan EntitySetName dari akun; /_api/accounts().
Catatan
Gunakan nama logika tabel untuk pengaturan situs ini (misalnya akun).
Anda dapat menentukan EntitySetName dari tabel tertentu dengan mengikuti langkah-langkah berikut:
Pilih tab Dataverse dari panel sisi, lalu pilih tabel.
Pilih ... (Pilihan perintah) dan kemudian pilih Tingkat Lanjut, Alat, dan Salin nama rangkaian untuk menyalin EntitySetName dari tabel ke clipboard.
Peraturan Perlindungan Data Umum (GDPR)
Semua header permintaan akan memiliki ID kontak yang diteruskan untuk tujuan audit. Untuk pengguna anonim, ini akan diteruskan sebagai null.
Jika pendataan audit diaktifkan, pengguna dapat melihat semua aktivitas audit dalam log audit Office 365.
Informasi selengkapnya:
Mengaktifkan dan menggunakan pencatatan aktivitas
Ekspor, konfigurasi, dan lihat rekaman log audit
Tabel konfigurasi yang tidak didukung.
API Web Portal tidak dapat digunakan untuk tabel konfigurasi berikut:
adx_contentaccesslevel
adx_contentsnippet
adx_entityform
adx_entityformmetadata
adx_entitylist
adx_entitypermission
adx_entitypermission_webrole
adx_externalidentity
adx_pagealert
adx_pagenotification
adx_pagetag
adx_pagetag_webpage
adx_pagetemplate
adx_portallanguage
adx_publishingstate
adx_publishingstatetransitionrule
adx_publishingstatetransitionrule_webrole
adx_redirect
adx_setting
adx_shortcut
adx_sitemarker
adx_sitesetting
adx_urlhistory
adx_webfile
adx_webfilelog
adx_webform
adx_webformmetadata
adx_webformsession
adx_webformstep
adx_weblink
adx_weblinkset
adx_webnotificationentity
adx_webnotificationurl
adx_webpage
adx_webpage_tag
adx_webpageaccesscontrolrule
adx_webpageaccesscontrolrule_webrole
adx_webpagehistory
adx_webpagelog
adx_webrole_systemuser
adx_website
adx_website_list
adx_website_sponsor
adx_websiteaccess
adx_websiteaccess_webrole
adx_websitebinding
adx_websitelanguage
adx_webtemplate
Masalah yang diketahui
Pengguna akan mendapatkan kesalahan CDS jika mereka mengaktifkan permintaan Web API GET untuk tabel yang memiliki beberapa tingkat 1 ke banyak atau banyak ke banyak izin tabel dengan cakupan induk yang ditentukan.
Untuk menangani masalah ini, solusi yang disarankan adalah menggunakan FetchXML di kueri OData.
Atau, atur pengaturan situs Webapi/<table name>/disableodatafilter ke True.
Penting
Mengubah pengaturan situs Webapi/<table name>/disableodatafilter ke True dapat mengakibatkan kinerja lebih lambat untuk panggilan GET Web API.
Pengaturan situs tersedia di versi portal 9.4.10.74 atau yang lebih baru.
Langkah selanjutnya
Data kueri menggunakan API Web portal
Baca juga
Menulis permintaan HTTP dan menangani kesalahan
Operasi Menulis, Memperbarui dan menghapus portal dengan menggunakan Web API
Tutorial: Menggunakan API Web portal
Catatan
Apa bahasa dokumentasi yang Anda inginkan? Lakukan survei singkat. (perlu diketahui bahwa survei ini dalam bahasa Inggris)
Survei akan berlangsung kurang lebih selama tujuh menit. Tidak ada data pribadi yang dikumpulkan (pernyataan privasi).