Pregled web API-ja za portale

Napomena

Od 12. listopada 2022. portali Power Apps postaju Power Pages. Više informacija: Usluga Microsoft Power Pages je sada javno dostupna (blog)
Uskoro ćemo migrirati i spojiti dokumentaciju za portale Power Apps s dokumentacijom za Power Pages.

Web API portali omogućuju bogatiji korisnički doživljaja na stranicama portala Power Apps. Web API možete upotrijebiti za provođenje operacija stvaranja, ažuriranja i brisanja svih tablica platforme Microsoft Dataverse 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.

Napomena

Portale Web API-ja možete koristiti i u usluzi Power Pages. Dodatne informacije: Što je Power Pages

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. Upotreba portala Web API za integraciju s drugim stranicama portala Power Apps također nije podržana.
  • 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 možete pronaći u tablicama nepodržanih konfiguracija kasnije u ovoj temi.
  • Portali Web API iskorištava prednosti predmemorije na strani poslužitelja pa su naknadni pozivi za Web API brži od početnih poziva. Napominjemo da brisanje predmemorije na strani poslužitelja uzrokuje privremeno pogoršanje performansi.
  • Operacije portala Web API zahtijevaju licencu za portale platforme Power Apps. 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 portala Power Apps

Operacije API-ja na webu

Web API portala pruža podskup mogućnosti za radnje servisa Dataverse koje možete obaviti s pomoću API-ja servisa Dataverse. API format zadržali smo što sličnijim da bismo skratili proces učenja.

Napomena

Operacije Web API-ja razlikuju velika i mala slova.

Operacije API-ja na webu dostupne na portalima

Napomena

Pozivanje radnje i funkcije pomoću portala Web API nije podržano.

Postavke web-mjesta za Web API

Morate omogućiti postavku web-mjesta da biste omogućili Web API portala za svoj portal. Isto tako možete konfigurirati Web API na razini polja koji određuje polja tablice koja se mogu ili ne mogu izmjenjivati putem portala Web API.

Napomena

Upotrijebite tablicu logički naziv za ove postavke (na primjer račun).

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
Bilješka: Vrijednost mora biti zvjezdica (*) ili popis naziva polja odvojenih zarezom.
Važno: Ovo je obavezna 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
Webapi/<table name>/disableodatafilter Omogućuje ili onemogućuje OData filter.
Zadano: False
Valjane vrijednosti: True, False Više informacija potražite u odjeljku poznati problemi. Postavka web-mjesta dostupna je u verziji portala 9.4.10.74 ili kasnijoj verziji.

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. Portali Web API pristupaju zapisima tablice (entitet) i prate dozvole tablice koje su dodijeljene korisnicima putem pridružene web-uloge.

Možete konfigurirati dopuštenja za stupce za dodatno utvrđivanje povlastica za pojedinačne stupce unutar tablice dok upotrebljavate portale Web API.

Sigurnost API-ja na webu portalu.

Provjera autentičnosti zahtjeva za API na webu portala

Ne morate uključiti kôd za provjeru autorizacije jer sesija aplikacije upravlja provjerom autentičnosti i autorizacijom. Svi pozivi Web API-ja moraju sadržavati token za Krivotvorene zahtjeve s drugih web-mjesta (CSRF).

Upotreba opcije EntitySetName

Kada se odnosi na tablice usluge Dataverse pomoću portala Web API-ja, trebate upotrijebiti opciju EntitySetName, na primjer za pristup tablici računa, sintaksa koda upotrijebit će opciju EntitySetName od računa; /_api/accounts().

Napomena

Upotrijebite tablicu logički naziv za postavke web-mjesta (na primjer račun).

Možete odrediti opciju EntitySetName određenih tablica slijedeći ove korake:

  1. Idite na https://make.powerapps.com

  2. Odaberite karticu Dataverse na bočnoj ploči i odaberite tablicu.

  3. Odaberite ... (Mogućnost naredbi), a zatim odaberite Napredna, Alati i Kopiraj naziv skupa da biste kopirali EntitySetName tablice u međuspremnik.

    Kako locirati EntitySetName tablice platforme Dataverse?

Opća uredba o zaštiti podataka (GDPR)

Sva zaglavlja zahtjeva imat će ID kontakta proslijeđen 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 nadzora Office 365.

Zapisnik nadzora u sustavu Office 365.

Dodatne informacije:
Omogućivanje i upotreba aktivnosti prijave u sustav
Izvezite, konfigurirajte i prikažite zapise zapisnika nadzora

Tablice nepodržanih konfiguracija

Portali Web API portali ne mogu se upotrijebiti za sljedeće tablice konfiguracija:

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

Poznati problemi

Korisnici će dobiti poruku o CDS pogrešci ako pozovu GET Web API zahtjev za tablice koje imaju više razina 1 prema mnogima ili mnogi prema mnogima dozvole za tablicu s definiranim nadređenim djelokrugom.

Za rješavanje ovog problema preporučuje se upotreba FetchXML u OData upitu.

Umjesto toga, postavite postavku web-mjesta Webapi/<table name>/disableodatafilter na True.

Važno

Promjena postavke web-mjesta Webapi/<table name>/disableodatafilter na True može dovesti do sporijeg rada za Web API GET pozive.

Postavka web-mjesta dostupna je u verziji portala 9.4.10.74 ili kasnijoj verziji.

Sljedeći korak

Slanje upita za podatak pomoću Web API-ja

Pogledajte

Sastavljanje HTTP zahtjeva i rješavanje pogrešaka
Portali dodaju, ažuriraju i brišu operacije pomoću Web API-ja
Vodič: upotreba portala Web API-ja

Napomena

Možete li nam reći više o željenim jezicima za dokumentaciju? Ispunite kratki upitnik. (imajte na umu da je upitnik na engleskom jeziku)

Ispunjavanje upitnika će trajati otprilike sedam minuta. Osobni podaci se ne prikupljaju (izjava o zaštiti privatnosti).