Översikt över webb-API-portaler
Med webb-API för portaler kan du skapa en rikare användarupplevelse i Power Apps-portalsidorna. Du kan använda webb-API för att skapa, läsa, uppdatera och ta bort åtgärder i Microsoft Dataverse-tabeller från portalsidorna. Du kan till exempel skapa ett nytt konto, uppdatera en kontakt eller ändra tabellbehörigheter för en produkt genom att använda portalerna Webb-API istället för portalhanteringsappen.
Viktigt
- Portalversionen måste vara 9.3.3.x eller senare för att den här funktionen ska fungera.
- Webb-API för portaler är byggd för att skapa en rikare användarupplevelse i portalsidorna. Det är inte optimerat för tredjepartstjänster eller programintegrering.
- Webb API-åtgärder för portaler är begränsade till tabeller som är relaterade till data—, till exempel konton, kontakter eller dina anpassade tabeller. Konfigurera data för tabellmetadata eller portalkonfigurationstabell—till exempel konfigurera portaltabeller som adx_contentsnippet, adx_entityform eller adx_entitylist—stöds inte med webb-API för portaler. En fullständig lista finns i konfigurationstabeller som inte stöds, längre fram i ämne.
- Portalernas webb-API har nytta av cachelagring på serversidan, så efterföljande anrop till webb-API:et är snabbare än de första anropen. Observera att om du avmarkerar portalens servercacheminne blir prestanda försämrade.
- Portalers webb-API-åtgärder kräver en Power Apps-portallicens. Webb-API-anrop som görs av anonyma användare räknas exempelvis in i sidvyns kapacitet. Webb-API-anrop från autentiserade användare (interna eller externa) räknas inte in i sidvyer, men kräver tillämpliga licenser. Mer information: Vanliga frågor om Power Apps-portalers licenser
Webb-API för åtgärder
Webb-API för portaler tillhandahåller en deluppsättning funktioner för Dataverse-åtgärder som du kan utföra med hjälp av API:t för Dataverse. API-formatet har hållits så likartat som möjligt för att minska inlärningskurvan.
Webb-API-åtgärder som är tillgängliga i portaler
- Läsa poster från en tabell
- Skapa en post i en tabell
- Uppdatera och ta bort poster i en tabell
- Associera och avassociera tabeller
Webbplatsinställningar för webb-API
Du måste aktivera webbplatsinställningen för att kunna aktivera webb-API:t för portalen. Du kan också konfigurera webb-API på fältnivå som bestämmer vilka tabellfält som kan eller inte kan ändras med portalens Webb-API.
| Webbplatsinställningsnamn | Beskrivning |
|---|---|
| Webapi/<table name>/aktiverad | Aktiverar eller inaktiverar webb-API för <table name>. Standard: False Giltiga värden: True, False |
| Webapi/<table name>/fält | Definierar den kommaseparerade listan över attribut som kan ändras med webb-API:t. Möjliga värden: - Alla attribut: * - Specifika attribut: attr1,attr2,attr3 Obs! Värdet måste antingen vara en asterisk (*_) eller en kommaavgränsad lista med fältnamn. _ Viktigt: Detta är en obligatorisk platsinställning. När den här inställningen saknas visas felmeddelandet "Inga fält har definierats för den här entiteten". |
| Webapi/error/innererror | Aktiverar eller inaktiverar InnerError. Standard: False Giltiga värden: True, False |
Anteckning
Webbplatsinställningarna måste anges som aktiva för att ändringarna ska börja gälla.
För att visa webb-API:t för ärendetabellen där autentiserade användare kan utföra åtgärder för att skapa, uppdatera och ta bort entiteten visas webbplatsinställningarna i följande tabell.
| Webbplatsinställningsnamn | Värde för webbplatsinställning |
|---|---|
| Webapi/incident/aktiverad | sant |
| Webapi/incident/fält | attr1,attr2,attr3 |
Säkerhet med webb-API för portaler
Du kan konfigurera postbaserad säkerhet för enskilda poster i portaler med hjälp av tabellbehörigheter. Portalers webb-API ger åtkomst till tabellposter (entitetsposter) och följer tabellbehörigheterna som ges till användare via den associerade webbrollen.
Autentisering av portaler för webb-API-begäranden
Du behöver inte ha med en autentiseringskod eftersom autentisering och auktorisering hanteras av programsessionen. Alla webb-API-anrop måste innehålla ett token för förfalskning av begäran mellan webbplatser.
Allmänna datasekretessregelverk (GDPR)
Alla begäransrubriker får ett kontakt-ID som skickas för granskningssyften. För en anonym användare skickas detta som null.
Om spårningsloggning har aktiverats kan en användare se alla spårningshändelser i spårningsloggen för Office 365.
Mer information:
Aktivera och använd loggning av aktiviteter
Exportera, konfigurera och visa poster i spårningsloggen
Konfigurationstabell som inte stöds
Webb-API för portaler kan inte användas för följande konfigurationstabeller:
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
Nästa steg
Frågedata med webb-API för portaler
Se även
Komponera HTTP-begäranden och hantera fel Portaler skriver, uppdaterar och tar bort åtgärder med hjälp av webb-API Självstudier: Använda webb-API:et med portaler