Pregled Web API-ja za portale
Portali Web API omogućavaju izgradnju bogatijeg korisničkog iskustva unutar Power Apps portala. Web API možete da koristite za izvršavanje operacija kreiranja, čitanja, ažuriranja i brisanja Microsoft Dataverse svih tabela sa stranica portala. Na primer, možete da napravite novi nalog, ažurirate kontakt ili promenite dozvole za tabelu za proizvod korišćenjem Web API-ja portala umesto aplikacije Portal Management.
Važno
- Verzija vašeg portala mora biti 9.3.3.x ili novija da bi ova funkcija mogla da funkcioniše.
- Web API za portale je izgrađen za kreiranje bogatog korisničkog iskustva unutar stranica portala. On nije optimizovan za usluge nezavisnih proizvođača ili za integraciju aplikacija.
- Web API operacije za portale su ograničene na tabele povezane sa podacima – na primer, kontakti, poslovni kontakti ili prilagođene tabele. Konfigurisanje metapodataka tabele ili podataka tabele konfiguracije portala – na primer, konfigurisanje tabela portala kao što su adx_contentsnippet, adx_entityform ili adx_entitylist – nije podržano Web API-jem za portale. Za kompletnu listu idite na nepodržane tabele konfiguracije kasnije u ovom tema.
- Portali Web API imaju koristi od keširanje na strani servera, tako da su naredni pozivi za Web API brži od početnih poziva. Imajte na umu da brisanje keša na strani servera portala uzrokuje privremenu degradaciju performansi.
- Web API operacije portala zahtevaju Power Apps portala. Na primer, pozivi veb API-ja koje upućuju anonimni korisnici računaju se u kapacitetu prikaza stranice. Pozivi veb API-ja koje su uputili korisnici sa potvrđenim identitetom (interni ili eksterni) ne računaju se u prikaze stranica, ali zahtevaju odgovarajuće licence. Još informacija: najčešća Power Apps za licenciranje portala
Operacije Web API-ja
Web API portala nudi podskup mogućnosti za Dataverse koje možete da uradite pomoću Dataverse API-ja. Zadržali smo API format što sličniji kako bismo smanjili krivu učenja.
Operacije Web API-ja dostupne na portalima
- Čitanje zapisa iz tabele
- Kreiranje zapisa u tabeli
- Ažuriranje i brisanje zapisa u tabeli
- Pridruživanje i razdvajanje tabela
Podešavanja lokacije za Web API
Morate omogućiti podešavanje lokacije da biste omogućili Web API za portale za svoj portal. Takođe možete da konfigurišete Web API na nivou polja koji određuje polja tabele koja se mogu ili ne mogu menjati pomoću Web API portala.
| Naziv podešavanja lokacije | Opis |
|---|---|
| Webapi/<table name>/enabled | Omogućava ili onemogućava Web API za <table name>. Podrazumevano: False Važeće vrednosti: True, False |
| Webapi/<table name>/fields | Definiše listu atributa odvojenih zarezom koji se mogu izmeniti pomoću Web API-ja. Moguće vrednosti: - Svi atributi: * - Specifični atributi: attr1,attr2,attr3 Napomena: Vrednost mora biti zvezdica (*_) ili lista imena polja odvojenih zarezom. _ Važno: Ovo je obavezno podešavanje lokacije. Kada ovo podešavanje nedostaje, videćete grešku „Za ovaj entitet nisu definisana polja“. |
| Webapi/error/innererror | Omogućuje ili onemogućuje InnerError. Podrazumevano: False Važeće vrednosti: True, False |
Napomena
Podešavanja lokacije moraju biti postavljena na Aktivno da bi promene stupile na snagu.
Na primer, da biste izložili Web API za tabelu Predmeta gde je ovlašćenim korisnicima dozvoljeno da obavljaju operacije kreiranja, ažuriranja i brisanja ovog entiteta, podešavanja lokacije su prikazana u sledećoj tabeli.
| Naziv podešavanja lokacije | Vrednost podešavanja lokacije |
|---|---|
| Webapi/incident/enabled | true |
| Webapi/incident/fields | attr1,attr2,attr3 |
Bezbednost pomoću Web API-ja za portale
Možete da konfigurišete zaštitu zasnovanu na zapisima za pojedinačne zapise na portalima koristeći dozvole za tabele. Web API portala pristupa zapisima tabele (entiteta) i sledi dozvole za tabelu koje se daju korisnicima putem pridružene Veb uloge.
Zahtevi za potvrdu identiteta za Web API za portale
Nije potrebno da uključite kôd potvrde identiteta jer se sesijom aplikacije upravlja potvrdom identiteta i autorizacijom. Svi pozivi Web API-ja moraju da sadrže token falsifikovanja unakrsnih zahteva između lokacija (CSRF).
Opšta uredba o zaštiti podataka (GDPR)
Sva zaglavlja zahteva će imati prosleđen ID kontakta u svrhe nadgledanja. Za anonimnog korisnika ovo će se proslediti kao null.
Ako je evidentiranje nadgledanja omogućeno, korisnik može da vidi sve događaje nadgledanja u Office 365 evidenciji nadzora.
Još informacija:
Omogućavanje i korišćenje vođenja evidencije o aktivnostima
Izvoz, konfigurisanje i prikazivanje zapisa evidencije nadzora
Nepodržane tabele konfiguracije
Web API portala ne može da se koristi za sledeće tabele konfiguracije:
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
Sledeći korak
Podaci upita pomoću Portala Web API
Pogledajte i
Sastavljanje HTTP zahteva i obrada grešaka Portali pišu, ažuriraju i brišu operacije pomoću Web API-ja Uputstvo: korišćenje Web API portala