PowerApps kan använda alla RESTful API, oavsett värd. Den här kursen visar hur du registrerar och använder ett anpassat API.

Förutsättningar

  • Ett PowerApps-konto.
  • En Swagger-fil (JSON) eller en webbadress till en Swagger-definition för ditt anpassade API. Om du inte har något visar vi dig flera alternativ för att skapa en Swagger-fil.
  • En bild som används som en ikon för ditt anpassade API (valfritt).

Autentisering

Anpassade API i PowerApps kan använda någon av flera autentiseringsmekanismer

  • API-nyckel
  • Enkel autentisering
  • Allmän OAuth 2.0
  • OAuth 2.0. De specifika implementeringarna nedan stöds för närvarande och fler kommer snart.

    • Azure Active Directory
    • Box
    • Dropbox
    • Facebook
    • Google
    • Instagram
    • OneDrive
    • SalesForce
    • Slack
    • Yammer

OpenAPI Specification beskriver hur du anger en autentisering inom en Swagger.

Om API-slutpunkten tillåter oautentiserad åtkomst bör du ta bort objektet securityDefintions från filen OpenAPI (Swagger). I följande exempel tar du bort alla följande securityDefintions-objekt:

  "securityDefinitions": {
    "AAD": {
      "type": "oauth2",
      "flow": "implicit",
      "authorizationUrl": "https://login.windows.net/common/oauth2/authorize",
      "scopes": {}
    }
  },

Exempel

Registrera ett anpassat API

Steg 1: Skapa en Swagger-fil

Du kan skapa en Swaggerfil från alla API-slutpunkter, inklusive:

  • Allmänt tillgängliga API:er. Några exempel omfattar Spotify, Uber, Slack, Rackspace med mera.
  • Ett API som du skapar och distribuerar till alla molnvärdleverantörer, inklusive Amazon Web Services (AWS), Heroku, Azure Web Apps, Google Cloud med mera.
  • En anpassad API för din verksamhet som distribueras på ditt nätverk så länge som ditt API är exponerat på internet.

När du skapar en Swagger-fil skapas en JSON-fil. Här behöver du Steg 2.

Ansluta till Azure App Service- eller Azure Functions

Om din API har skapats med Azure App Service eller Azure Functions, se Exportera en API på Azure till PowerApps för mer information.

Få hjälp med Swagger-filer

Steg 2: Registrera anpassat API

Nu när Swagger-filen (JSON-fil) har skapats för ett anpassade API ska du registrera ditt anpassade API i PowerApps

  1. I menyn till vänster på powerapps.com klickar du på Connections. Klicka på ... och välj hantera anpassade API:er i det övre högra hörnet.

    Tip:

    Om du inte hittar menyn kan den vara under ikonen med tre vågräta streck i mobilwebbläsarens övre vänstra hörn.

    Skapa anpassad API

  2. Välj Nytt anpassat API:

    Anpassade API-egenskaper

    Du uppmanas att ange egenskaperna för ditt API.

    Egenskap Beskrivning
    Swagger-webbadress eller Swagger API-definition Klistra in en webbadress i en Swagger-definition eller bläddra till JSON-filen som skapades från Swagger-filen.
    Namn Skriv namnet på din anpassade API.
    Överför API-ikon Bläddra till en bildfil för ikonen (valfritt).
    Beskrivning Ange en beskrivning av ditt anpassade API (valfritt).

    Välj Nästa.

  3. Ange egenskaper för autentisering. Om JSON-filen använder OAuth2 autentisering i objekt securityDefintions uppmanas du att följande värden:

    Egenskap Beskrivning
    Klient-id Ett klient-ID tillhandahålls från en av OAuth-identitetsprovidrarna som stöds. Ange detta klient-ID.
    Klienthemlighet Skriv in klienthemligheten från den valda identitetsprovidern.

    Referera till exemplen för Azure Resource Manager och Azure WebApp för information om hur du konfigurerar AAD-autentiseringsvärden.

    Om JSON-filen inte använder objektet securityDefintions behövs inga ytterligare värden.

  4. Välj Skapa.

    Din anpassade API visas nu under Anpassade.

    Tillgängliga API:er

    Tip:

    Om det inte går att validera Swagger-filen kan det finnas extra tecken. Merparten av alla data bör till exempel vara inom citattecken, inklusive webbadresser.

  5. Nu när ditt anpassade API är registrerat måste du skapa en anslutning till ditt anpassade API så att det kan användas i dina appar. Klicka på + till höger om det ändrade datumet för ditt anpassade API och slutför eventuella nödvändiga åtgärder för att logga in på din API-datakälla. Om du använder OAuth-autentisering med ditt API visas eventuellt en inloggningsskärm. För autentisering med API-nyckel kan du uppmanas att ange ett nyckelvärde.

Steg 3: Lägga till anpassade API i en app

Lägg till anpassat API i en app precis som andra datakällor och använd sedan ditt API i funktionsfältet, en textruta eller liknande. Till exempel i funktionsfältet kan du börja skriva MySampleWebAPI för att se tillgängliga funktioner. Office 365 Outlook är ett exempel på hur du använder ett Office 365 API.

Dela ett anpassat API

Användarna kan också dela anpassade API:er med varandra.

  1. I menyn till vänster på powerapps.com klickar du på Connections. Klicka på ... och välj hantera anpassade API:er i det övre högra hörnet.

    Ny anslutning

  2. Välj ditt API, välj Dela och ange sedan de användare eller grupper som du vill bevilja åtkomst till ditt API.

    Dela anpassat API

  3. Välj Spara.

Note:

Du kan endast dela anpassade API:er med andra användare i din organisation.

Kvot och begränsning

  • Se sidan PowerApps priser för information om anpassade API-kvoter. Anpassade API:er som delas med dig räknas inte mot kvoten.
  • Användare kan göra upp till 500 anrop per minut för varje anslutning som skapats på ett anpassat API.
  • Alla anslutningar som har skapats för ett API tas bort om du raderar ett anpassat API.
  • Storleken på din Swagger-fil ska vara under 1 MB.

Nästa steg

Lär dig mer om anpassade Swagger-tillägg.

Använd ett ASP.NET Web API.

Registrera ett Azure Resource Manager API.