Elke REST API koppelen aan je Azure datawarehouse en Power BI
Elke REST API als bron
Yres koppelt elke REST API die JSON teruggeeft via één generiek formulier. Je geeft de basis-URL op, kiest hoe de API aanmeldt (anoniem, Basic of OAuth2 client credentials) en hoe ze pagineert, en legt per tabel het endpoint vast. Yres haalt de volledige respons op, ontleedt de JSON in je Azure SQL-database en maakt de tabel zelf aan, zonder veldmapping. Daarna volgt de gewone laadroute met historie (SCD2), klaar voor Power BI. Zo koppel je ook systemen die niet in de bronnenlijst staan.
In het kort
- Verbinding
- Generieke REST-koppeling voor elke API die JSON teruggeeft. Eén basis-URL per bron, één endpoint per tabel
- Aanmelden
- Anoniem, Basic (gebruikersnaam en wachtwoord) of OAuth2 client credentials (token-endpoint, client ID, client secret, scope en eventueel resource). Extra HTTP-headers, zoals een API-key-header, voeg je los toe
- Paginatie
- Geen paginatie, Link-headers volgens RFC 5988, een volgende-pagina-URL in de respons, offset en limit, paginanummer, of paginanummer met limit. De lus stopt zodra een pagina geen rijen meer oplevert
- Endpoints kiezen
- Publiceert de API een OpenAPI 3-specificatie (JSON of YAML), dan kies je de endpoints uit die specificatie. Zonder specificatie vul je het endpoint per tabel zelf in
- JSON naar tabel
- De respons wordt in de database ontleed. Yres vindt de lijst met records zelf, slaat geneste objecten plat tot 10 niveaus diep, bewaart arrays binnen een record als JSON-tekst en voegt een kolom toe zodra er een nieuw veld verschijnt
- Waar draait het
- Als Azure Data Factory-pipelines in je eigen Azure-tenant. Een self-hosted integration runtime is alleen nodig als de API on-premises of achter een firewall staat
- Basis-URL en inloggegevens
- Worden weggeschreven naar de Key Vault in je eigen Azure-omgeving; de webapplicatie van Yres bewaart zelf geen geheimen
Wat je zelf regelt
- 1Zoek de API-documentatie van je systeem erbij en noteer de basis-URL (zonder afsluitende schuine streep) en, als die bestaat, de URL van de OpenAPI-specificatie.
- 2Bepaal hoe de API aanmeldt: anoniem, Basic of OAuth2 client credentials. Vraag bij de leverancier de gebruikersnaam en het wachtwoord aan, of de client ID, het client secret, het token-endpoint en de scope. Noteer ook verplichte headers, zoals een API-key-header.
- 3Zoek op hoe de API resultaten in pagina's opdeelt en hoe de bijbehorende parameters heten (bijvoorbeeld offset en limit, of page).
- 4Voeg in Yres de bron REST API toe, vul deze gegevens in en kies de integration runtime.
- 5Voeg per endpoint een tabel toe. Laat het pad naar de records op automatisch staan, of vul het zelf in als de API een ongebruikelijke structuur heeft.
Wanneer heb je dit nodig — en wanneer niet
Een losse connector is genoeg als…
Gaat het om één endpoint met een korte lijst die je in één rapport gebruikt, dan kan Power BI die API ook rechtstreeks aanroepen. Dat is sneller ingericht dan een datawarehouse.
Yres voegt iets toe als…
Yres wordt zinvol zodra de API pagineert of tokens vereist, de JSON genest is of in de tijd verandert, je wilt bewaren hoe de gegevens er eerder uitzagen, of de API-data naast je ERP- en HR-cijfers moet staan. Dan hoef je geen eigen script te schrijven en te onderhouden.
Veelgestelde vragen: REST API
Mijn systeem staat niet in jullie bronnenlijst. Kan ik het toch koppelen?
In de meeste gevallen wel. Biedt het systeem een REST API die JSON teruggeeft, dan koppel je het met de generieke REST-koppeling; biedt het een OData-feed, dan met de OData-koppeling. Een aantal bronnen uit de lijst werkt onder water op dezelfde manier. Twijfel je of jouw API past, neem dan contact op; we kijken mee naar de documentatie.
Wat moet ik van mijn API weten voordat ik begin?
Vier dingen, alle vier te vinden in de API-documentatie: de basis-URL, de manier van aanmelden (anoniem, Basic of OAuth2 client credentials, plus eventuele verplichte headers), de manier van pagineren met de namen van de parameters, en de endpoints die je wilt uitlezen. Heeft de API een OpenAPI-specificatie, dan neemt die het laatste punt grotendeels over.
Hoe gaat Yres om met geneste JSON?
Geneste objecten worden platgeslagen tot kolommen, tot 10 niveaus diep; address.city wordt bijvoorbeeld een eigen kolom. Een array binnen een record wordt niet uitgesplitst maar als JSON-tekst in één kolom bewaard; die werk je desgewenst later uit in een SQL-view. Kolommen en datatypes worden bepaald op de eerste 10.000 records van een respons, dus bij grote resultaten is paginatie verstandig: elke pagina wordt dan apart ontleed.
Wat is het verschil met de OData-koppeling?
Een OData-feed beschrijft zichzelf: de service vertelt welke entiteiten en velden er zijn en geeft zelf de link naar de volgende pagina. Bij een gewone REST API bestaat die afspraak niet. Daar geef jij aan welk endpoint je leest en hoe er gepagineerd wordt, en leidt Yres de kolommen af uit de JSON die binnenkomt. Spreekt je systeem OData, kies dan de OData-koppeling.
Volledige technische beschrijving in de kennisbank →·Laatst gecontroleerd:
Datawarehouse-automatisering die in je eigen Azure draait
Gebouwd voor organisaties op Azure en Power BI. Yres koppelt je bronnen, bewaart de historie en rolt wijzigingen gecontroleerd uit, zonder handwerk.