Pregled spletnega API-ja za portale

Spletni API portalov omogoča bogatejšo uporabniško izkušnjo v notranjosti Power Apps strani portalov. Spletni API lahko uporabite za izvajanje operacij ustvarjanja, branja, posodabljanja in brisanja v vseh Microsoft Dataverse tabele s strani vaših portalov. S spletnim API-jem portalov lahko namesto z aplikacijo za upravljanje portala za izdelek ustvarite na primer nov račun, posodobite stik ali spremenite dovoljenja za tabele.

Opomba

Uporabite lahko tudi spletni API portalov v Power Pages. Več informacij: Kaj je Power Pages

Pomembno

• Za delovanje te funkcije morate imeti portal različice 9.3.3.x ali novejše.
• Spletni API portalov je bil ustvarjen za grajenje bogate uporabniške izkušnje znotraj strani portalov. Ni optimiziran za storitve tretjih ponudnikov ali integracijo aplikacij.
• Delovanje spletnih API-jev portalov je omejeno na tabele, povezane s podatki— na primer računi, stiki ali tabelami po meri. Konfiguriranje metapodatkov tabele ali podatkov konfiguracijske tabele portala— na primer konfiguriranje tabel portalov, kot so adx_contentsnippet, adx_entityform ali adx_entitylist— ni podprt s spletnim API-jem portalov. Za popoln seznam pojdite na nepodprte konfiguracijske tabele kasneje v tem tema.
• Spletni API portalov ima koristi predpomnjenje na strani strežnika, zato so nadaljnji klici spletnega API-ja hitrejši od začetnih klicev. Upoštevajte, da brisanje strežniškega predpomnilnika povzroči začasno slabše delovanje.
• Operacije spletnega API-ja portalov zahtevajo a Power Apps licenca portalov. Na primer, klici spletnega API-ja, ki jih opravijo anonimni uporabniki, se štejejo v zmogljivost ogleda strani. Klici spletnega API-ja, ki jih opravijo overjeni uporabniki (notranji ali zunanji), se ne štejejo med oglede strani, vendar zahtevajo ustrezne licence. Več informacij: Pogosta vprašanja o licenciranju portalov Power Apps

Postopki spletnih API-jev

Spletni API portala ponuja podmnožico zmogljivosti za operacije Dataverse, ki jih lahko izvedete z uporabo API-ja Dataverse. Format API-ja smo ohranili čim bolj podoben, da zmanjšamo krivuljo učenja.

Postopki spletnih API-jev, ki so na voljo na portalih

• Preberite zapise iz tabele
• Ustvarjanje zapisa v tabeli
• Posodobitev in izbris zapisov v tabeli
• Povezovanje in ločevanje tabel

Nastavitve spletnega mesta za spletni API

Če želite za svoj portal omogočiti spletni API portalov, morate omogočiti nastavitev spletnega mesta. Prav tako lahko konfigurirate spletni API na ravni polja, ki določa polja tabele, ki jih lahko ali ne morete spreminjati s spletnim API-jem portalov.

Ime nastavitve mesta	Opis
Webapi/<table name>/enabled	Omogoči ali onemogoči spletni API za <table name>. Privzeto: False Veljavne vrednosti: True, False
Webapi/<table name>/fields	Določa seznam atributov, ločenih z vejicami, ki jih je mogoče spremeniti s spletnim API-jem. Možne vrednosti: - Vsi atributi: * - Določeni atributi: attr1,attr2,attr3 Opomba: vrednost mora biti bodisi zvezdica (*_) ali seznam imen polj ločenih z vejico. _ Pomembno: to je obvezna nastavitev spletnega mesta. Če ta nastavitev manjka, se vam bo prikazala napaka »Za to entiteto ni določeno nobeno polje«.
Webapi/error/innererror	Omogoči ali onemogoči InnerError. Privzeto: False Veljavne vrednosti: True, False

Opomba

Nastavitve mesta morajo biti nastavljene na Aktivno, da spremembe začnejo veljati.

Če želite na primer izpostaviti spletni API za tabelo primerov, kjer lahko uporabniki s preverjeno pristnostjo izvajajo postopke ustvarjanja, posodabljanja in brisanja te entitete, so nastavitve spletnega mesta prikazane v naslednji tabeli.

Ime nastavitve mesta	Vrednost nastavitve mesta
Webapi/incident/enabled	true
Webapi/incident/fields	attr1,attr2,attr3

Varnost s spletnim API-jem portalov

Varnost na podlagi zapisov lahko za posamezne zapise na portalih konfigurirate z dovoljenji za tabele. Spletni API portalov dostopa do zapisov tabele (entitet) in sledi dovoljenjem tabele, danim uporabnikom prek povezanih spletna vloga.

Lahko konfigurirate dovoljenja za stolpec za nadaljnje definiranje privilegijev za posamezne stolpce v tabeli med uporabo spletnega API-ja portalov.

Preverjanje pristnosti zahtevkov spletnih API-jev za portale

Ni vam treba vključiti kode za preverjanje pristnosti, ker preverjanje pristnosti in avtorizacijo upravlja seja aplikacije. Vsi klici spletnega API-ja morajo vsebovati žeton za ponarejanje zahteve prek spletnih mest (CSRF).

Splošna uredba o varstvu podatkov (GDPR)

Vse glave zahteve bodo imele posredovan ID stika za namene revizije. Za anonimnega uporabnika bo posredovan kot null.

Če je vodenje dnevnika nadzora omogočeno, lahko uporabnik vidi vse dogodke nadzora v dnevniku nadzora za Office 365.

Več informacij:
Omogočite in uporabite beleženje dejavnosti
Izvozite, konfigurirajte in si oglejte zapise revizijskega dnevnika

Nepodprte konfiguracijske tabele

Spletni API portalov ni mogoče uporabiti za naslednje konfiguracijske tabele:

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

Naslednji korak

Poizvedovanje podatkov z uporabo portalov Web API

Glejte tudi

Sestavljanje zahtev HTTP in obravnava napak
Portali pišejo, posodabljajo in brišejo operacije z uporabo spletnega API-ja
Vadnica: Uporabite spletni API portala

Opomba

Ali nam lahko poveste, kateri je vaš prednostni jezik za dokumentacijo? Izpolnite kratko anketo. (upoštevajte, da je v angleščini)

Z anketo boste porabili približno sedem minut. Ne zbiramo nobenih osebnih podatkov (izjava o zasebnosti).