Undersøg og test Dataverse i web-API-legepladsen (forhåndsversion)

[Dette emne er til dokumentationen til den foreløbige udgivelse. Der kan forekomme ændringer.]

API-api'en er et forudinddelt softwaretestværktøj, der hjælper beslutningstagere med hurtigt og nemt at kommunikere med Microsoft Dataverse web-API.

Dette webprogram giver udviklere mulighed for at teste og eksperimentere med forskellige API-slutpunkter uden behov for omfattende konfigurations- eller godkendelsesprocesser. Den indeholder også praktiske oplysninger om tilgængelige handlinger og links til dokumentation for at få hurtigere læring.

Brug dette værktøj til at undersøge, hvad der er muligt i RESTful API, teste brugerdefinerede arbejdsprocesser og meget mere.

Vigtige oplysninger

• Dette er en forhåndsversion af funktionen.
• Forhåndsversionsfunktionerne er ikke beregnet til produktionsformål og kan have begrænset funktionalitet. Disse funktioner er tilgængelige før en officiel udgivelse, så kunderne kan få tidlig adgang og give feedback.

Nøglefunktioner

• Præauthenticated: API-api'en er præauthenticeret, så udviklere kan starte test og eksperimentere med API-slutpunkter med det samme.
• Webbaseret: Med API-legeplads kan udviklere hurtigt arbejde med Dataverse web-API'en uden behov for omfattende konfiguration, f.eks. softwareoverførsler eller ikke-Microsoft-kontokonfiguration. Du kan få adgang til værktøjet fra Dataverse acceleratoren, en Microsoft-app, der er tilgængelig i alle nye Dataverse-miljøer, og som kan installeres i alle miljøer.
• Praktisk: Indeholder de forskellige handlinger og funktioner, der findes i Dataverse-web-API'en, så du hurtigt kan lære, hvad der er muligt, og hvordan du implementerer det.

Forudsætninger

Du skal have adgang til Dataverse og adgang til at kunne spille Dataverse acceleratorappen. Medlemmer af sikkerhedsrollen Systemtilpasser har adgang til af afspille appen.

Start her

Du kan komme i gang med API-legepladsen ved at spille Dataverse-acceleratoren og derefter vælge API-siden for legeplads.

Anmode om web-API'en Dataverse

Vælg anmodningstypen på landingsskærmen for at åbne anmodningseditoren ved at vælge Opret på et af de øverste kort.

Der vises tre anmodningstyper:

Type	Description
Brugerdefineret API	Dette omfatter Dataverse web-API -handlinger, -funktioner fra Microsoft eller offentlige brugerdefinerede API'er, der er registreret i arbejdsmiljøet.
Øjeblikkeligt plug-in	Øjeblikkelig plug-ins er klassificeret som alle brugerdefinerede arbejdsprocesser, der er registreret som en brugerdefineret API i miljøet med en relateret arbejdsprocesser.
OData-anmodning	Gør det muligt for en mere detaljeret kontrol over anmodningsinput at sende OData-forespørgsler.

Anmode om en brugerdefineret API eller en instant plug-in

Disse anmodningstyper er udviklet til at forenkle de plug-ins, der er tilgængelige i arbejdsmiljøet.

1. Vælg en indstilling på den primære rulleliste, der præsenterer de tilgængelige plug-ins i det aktuelle miljø.

2. Hvis der er tilgængelige parametre, vises de i tabellen i Parameter for forespørgsler, der vises. Angive værdier til påkrævede parametre.

   Bemærk

   Afkrydsningsfelter til venstre for hver parameter angiver, om de er medtaget i anmodningen. Obligatoriske parametre har deaktiveret afkrydsningsfelter, mens valgfrie parametre har redigerbare parametre.

3. Vælg Send.

4. Observer svaret i nederste del af skærmen.

Bemærk

Brugergrænsefladen giver en praktisk oversigt over alle tilgængelige plug-ins i miljøet. Når indstillingen vælges, vises de tilknyttede parametre med datatyper. I baggrunden foretages der stadig et OData-opkald, men grænsefladen forenkler telefonopkaldet.

Foretag en OData-forespørgsel

OData-forespørgsler tillader flere indstillinger for anmodningsparametre.

1. Vælg metoden HTTP-anmodning på den første rulleliste.

2. Skriv slutpunkt url-adresse. Inkluder kun webadressen til anmodningen efter [OrgUrl]/api/data/v9.2/

3. Tilføj forespørgselsparametre ved hjælp af en af de to metoder:

   1. I URL-adressen.

      1. Når spørgsmålstegnet (?) angivet i URL-adressen, skal du skrive parameternøglen for forespørgslen.

      2. Skriv et lighedstegn (=) efter nøglen.

      3. Skriv i værdien.

      Nøglerne og værdierne udfylder automatisk parametertabellen i brugergrænsefladen.

   2. Tilføj forespørgselsparametre manuelt ved at vælge + Tilføj param. Derved føjes der en tom parameterrække til tabellen, hvor du kan skrive værdier. URL-adressen opdateres dynamisk, efterhånden som der angives værdier.

4. Du kan også angive et brødtekst (hvis du bruger alle anmodningsmetoder undtagen GET) ved at vælge fanen Brødtekst og derefter angive brødtekstværdien i editorkontrolelementet.

5. Vælg Send.

6. Observer svaret i nederste del af skærmen.

Vise svaret

Når en forespørgsel er sendt, vises svaret i nederste halvdel af skærmen.

Responsstatussen indeholder hurtige metrikværdier for anmodningen:

• Statusmeddelelse
• Varighed (i millisekunder)
• Størrelse (i kb)

Svarteksten vises under svarstatus. Vælg kopiikonet for at kopiere brødteksten for svaret til Udklipsholder.

Ofte stillede spørgsmål om

Hvilke rettigheder kræves for at få adgang til API-legepladsværktøjet?

Du skal have adgang til Dataverse-acceleratorappen for at bruge værktøjet.

Opretter værktøjet til API-værktøj kun forbindelse til web-API'en Dataverse?

Ja, API-værktøj kun forbindelse til web-API'en til Dataverse? Der findes ingen andre tjenester, der kan oprettes forbindelse til i denne brugergrænseflade.

Hvordan kan værktøjet til API-værktøj godkende til web-API'en Dataverse?

Værktøjet bruger godkendelsestokenet for den bruger, der er logget på, som kræves for at kunne afspille Dataverse-acceleratorprogrammet.

Er funktionen til API-legepladsfunktionen i alle miljøer?

Funktionen leveres via Dataverse-acceleratoren og er tilgængelig i alle miljøer, hvor appen er installeret. Appen installeres automatisk i alle nye miljøer, men kan også installeres i ældre miljøer ved at følge installationsanvisningerne.

Se også

Få prøveversionsfunktioner tidligt med Dataverse-acceleratoren (forhåndsversion)