Pregled Web API-ja za portale
Web API portala omogućuje izgradnju bogatijeg korisničkog iskustva unutar stranica Power Apps portala. Web-API možete koristiti za izvođenje operacija stvaranja, čitanja, ažuriranja i brisanja na svim Microsoft Dataverse tablicama sa stranica portala. Na primjer, možete stvoriti novi račun, ažurirati ugovor ili promijeniti dozvole tablice za proizvod upotrebom web-API-ja portala umjesto aplikacije za upravljanje portalima.
Važno
- Verzija vašeg portala mora biti 9.3.3.x ili novija da bi ova značajka radila.
- Web API portala namijenjen je za stvaranje bogatog korisničkog doživljaja na stranicama portala. Nije optimiziran za servise trećih strana ili integraciju aplikacija.
- Operacije web-API-ja portala ograničene su na tablice koje se odnose na podatke—primjerice na račune, ugovore ili vaše prilagođene tablice. Konfiguriranje metapodatka tablice ili podataka tablice konfiguracije—primjerice konfiguriranje tablice portala kao što su adx_contentsnippet, adx_entityform ili adx_entitylist—nije podržano s web-API-jem portala. Potpuni popis potražite u nepodržanim konfiguracijskim tablicama u nastavku ovog tema.
- Portali Web API imaju koristi od predmemoriranja na strani poslužitelja, tako da su naknadni pozivi web-API-u brži od početnih poziva. Napominjemo da brisanje predmemorije na strani poslužitelja uzrokuje privremeno pogoršanje performansi.
- Za operacije web-API-ja portala potrebna je licenca za Power Apps portale. Na primjer, pozivi web API-jeva anonimnih korisnika računaju se u kapacitet pregleda stranice. Pozivi web API-jeva korisnika kojima je provjerena autentičnost (unutarnji ili vanjski) ne računaju se u prikaze stranice, ali zahtijevaju odgovarajuće licence. Dodatne informacije: najčešća pitanja o licenciranju Power Apps portala
Operacije API-ja na webu
Web-API portala nudi podskup mogućnosti za Dataverse operacije koje možete učiniti pomoću API-ja za Dataverse. Zadržali smo API format što je moguće sličniji kako bismo smanjili krivulju učenja.
Operacije API-ja na webu dostupne na portalima
- Čitanje zapisa iz tablice
- Stvaranje zapisa u tablici
- Ažuriranje i brisanje zapisa u tablici
- Pridruživanje i poništavanje pridruživanja tablica
Postavke web-mjesta za Web API
Morate omogućiti postavku web-mjesta da biste omogućili Web API portala za svoj portal. Također možete konfigurirati web-API na razini polja koji određuje polja tablice koja se mogu ili ne mogu mijenjati pomoću web-API-ja portala.
| Naziv postavke web-mjesta | Opis |
|---|---|
| Webapi/<table name>/enabled | Omogućuje ili onemogućuje Web API za <table name>. Zadano: False Valjane vrijednosti: True, False |
| Webapi/<table name>/fields | Definira popis atributa odvojenih zarezom koji se mogu mijenjati s pomoću Web API-ja. Moguće vrijednosti: - Svi atributi: * - Specifični atributi: attr1,attr2,attr3 Napomena: Vrijednost mora biti zvjezdica (*_) ili popis naziva polja odvojenih zarezom. _ Važno : Ovo je obvezna postavka web-mjesta. Ako ta postavka nedostaje, vidjet ćete pogrešku Za ovaj entitet nisu definirana polja. |
| Webapi/error/innererror | Omogućuje ili onemogućuje InnerError. Zadano: False Valjane vrijednosti: True, False |
Napomena
Postavke web-mjesta moraju biti postavljene na Aktivno da bi promjene stupile na snagu.
Na primjer, za izlaganje web-API-ja za tablicu Slučaj, gdje je korisnici kojima je provjerena autentičnost dopušteno da provedu operacije stvaranja, ažuriranja i brisanja na ovom entitetu, postavke web-mjesta prikazane su u sljedećoj tablici.
| Naziv postavke web-mjesta | Vrijednost postavke web-mjesta |
|---|---|
| Webapi/incident/enabled | true |
| Webapi/incident/fields | attr1,attr2,attr3 |
Sigurnost uz Web API portala
Sigurnost na temelju zapisa možete konfigurirati za individualne zapise na portalima s pomoću dozvola tablice. Web-API portala pristupa zapisima tablice (entiteta) i slijedi dozvole tablice dane korisnicima putem pridružene web-uloge.
Provjera autentičnosti zahtjeva za API na webu portala
Ne morate uključiti kôd za provjeru autentičnosti jer sesijom aplikacije upravlja provjera autentičnosti i autorizacija. Svi pozivi Web API-ja moraju sadržavati token za Krivotvorene zahtjeve s drugih web-mjesta (CSRF).
Opća uredba o zaštiti podataka (GDPR)
Sva zaglavlja zahtjeva imat će proslijeđen ID kontakta u svrhu nadzora. Za anonimnog će se korisnika proslijediti kao null.
Ako je omogućeno zapisivanje nadzora, korisnik može vidjeti sve događaje nadzora u zapisniku Office 365 nadzora.
Dodatne informacije:
Omogućivanje i korištenje zapisivanja aktivnosti
Izvoz, konfiguriranje i prikaz zapisa zapisnika nadzora
Tablice nepodržanih konfiguracija
Web-API portala ne može se koristiti za sljedeće konfiguracijske tablice:
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
Sljedeći korak
Podaci upita pomoću web-API-ja portala
Pogledajte
Sastavljanje HTTP zahtjeva i rješavanje pogrešaka Portali pišu, ažuriraju i brišu operacije pomoću web-API-ja Praktični vodič: Korištenje web-API-ja portala