Learn Config Import Excel - aliconnect/aliconnect.sdk GitHub Wiki

Create Excel web API import

Introductie

Create API call URL

paths:
  /excel/omzet:
    get:
      operationId: Excel.omzet
      security:
      - basic_auth:
        - read:report

Create API function

  1. Create or Edit file /sites/{domain}/api.php
  2. Create operationId method.
class Excel {
  public function omzet () {
    die('<!DOCTYPE html><html><body>
    <table>
    <caption>Omzet gegevens
    <thead>
    <tr><td>Waarde
    
    <tbody>
      <tr><td>'.$waarde.'
    
    ');
    die();
  }
}

Create API Key

Genereer een API key met de juiste scope om de gegevens op te halen.

  1. https://airo.aliconnect.nl/docs/develop/get-auth-tokens
  2. client_secret: Voer de client_secret van het domein in. Deze is alleen bekend bij beheerders van het domein.
  3. scope: Voer in de scope van de key. Deze moet minimaal de security waarde bevatten van het API pad. In dit voorbeeld read:report
  4. Expires after: Het aantal dagen dat de key geldig is. Bijvoorbeeld 30.
  5. Klik verder
  6. Kopieer de key naar je klembord.

Gebruikers

Maak een document waar de gegevens worden weergegeven

  1. Maak een nieuw excel document aan
  2. Selecteer in menu: Gegevens / Gegevens ophalen en transformeren / Van het web
  3. Selecteer optie: Geavanceerd
  4. URL-onderdelen:
  5. type de URL van de API bijvoorbeeld https://airo.aliconnect.nl/api
  6. type het pad van de API call bijvoorbeeld /excel/omzet
  7. Parameters van HTTP-aanvraagheader (optioneel)
  8. Voer in 'X-API-Key' met als waarde de ontvangen/gekopieerde API-Key
  9. Klik op OK excel_web_api_import1
  10. Selecteer de gewenste data bijvoorbeeld: 'Monthly savings' excel_web_api_import2

In dit geval staat de API key hard gecodeerd in de header. Deze kan je optioneel maken

  1. Menu: Gegevens / Query's en verbindingen / Query's en verbindingen
  2. Hover over de verbinding en klik op BEWERKEN.
  • Power Query-editor start op.
  1. Menu: Start / Query / Geavanceerde editor
  2. Wijzig de aanroep Bron = Web.Page(Web.Contents("https://domain.aliconnect.nl/api/path" met optie , [ApiKeyName = "X-API-Key"]
  3. Sla alles op en kies nu bij openen optie API-Key.
let
    Bron = Web.Page(Web.Contents("https://domain.aliconnect.nl/api/path", [ApiKeyName = "X-API-Key"]))
in
    ...
⚠️ **GitHub.com Fallback** ⚠️