Platform · Module · Data-API

Eén gecontroleerde query, als beveiligde API.

Met de data API van ENABLE publiceer je een opgeslagen SQL-query als REST-endpoint op je eigen datawarehouse. Andere systemen halen het resultaat op met een eigen API-sleutel, via een vaste URL en een OpenAPI-specificatie. Elke publicatie krijgt een versienummer, zodat je altijd ziet wat er draait en kunt terugzetten.

Plan een demo Alle modules

enable.dataanalytics.nl/acme

NederlandsKlantbeheerderSV

Publiceren als API

Opgeslagen query · omzet-per-regio · versie 3

Endpoint

Endpoint slugomzet-per-regio

URLGET/api/v1/queries/omzet-per-regio

X-API-Keyak_••••••••••••3f9a

Rate limit60 verzoeken / min

ToegangAlleen-lezen

OpenAPI-specificatie bekijken

Test call 200 OK · 184 ms

{
  "query": "omzet-per-regio",
  "version": 3,
  "rows": [
    { "regio": "Zuid", "omzet_2026": 1421300 },
    { "regio": "Noord", "omzet_2026": 1284900 },
    …
  ]
}

Een data API maakt cijfers uit je datawarehouse beschikbaar voor andere systemen, zonder dat die systemen zelf in je database hoeven. In ENABLE publiceer je daarvoor een query die je al in de SQL Explorer hebt geschreven en gecontroleerd. Die query wordt een REST-endpoint dat een ander systeem met een API-sleutel kan aanroepen.

Het grote voordeel: iedereen haalt dezelfde, gecontroleerde cijfers op. De definitie van "omzet" of "openstaande orders" staat op één plek, in één query met een versienummer, en niet in vijf verschillende scripts of exports.

Endpoints zijn alleen-lezen. Ze draaien in een alleen-lezen transactie op je datawarehouse, met een rijlimiet per endpoint en een rate limit per aanroeper. Alleen klantbeheerders kunnen queries publiceren.

Functies

Wat Data-API doet

Publiceren vanuit de SQL Explorer

Sla een query op, kies een korte naam voor de URL en publiceer. Het endpoint gebruikt precies de SQL die je hebt getest, niet een kopie die later uit elkaar loopt.

API-sleutel per endpoint

Elk endpoint krijgt een eigen sleutel. ENABLE toont die eenmalig en bewaart alleen een hash. Lekt een sleutel uit, dan vervang je hem met één klik.

Parameters met type

Maak een query flexibel met tot twintig parameters, zoals een datum of klantcode. Per parameter kies je tekst, getal, datum of ja/nee, verplicht of met een standaardwaarde.

Versies en terugzetten

Elke publicatie krijgt een nieuw versienummer. In de versiegeschiedenis zie je wie wanneer heeft gepubliceerd, en een eerdere versie zet je terug als nieuwe publicatie.

OpenAPI-specificatie

ENABLE genereert een OpenAPI 3-specificatie van al je gepubliceerde endpoints, met parameters, rijlimiet en beveiliging. Ontwikkelaars kunnen daar direct mee aan de slag.

Rijlimiet en cache

Per endpoint stel je een maximum aantal rijen in (standaard 5.000, maximaal 50.000). Het antwoord meldt of het resultaat is afgekapt. Optioneel cache je antwoorden tot een uur.

Uitzetten en logging

Zet een endpoint uit wanneer het niet meer nodig is. Publicaties komen in het activiteitenlog van je organisatie, met versie en rijlimiet.

Een data API op je datawarehouse: zo werkt het

Een API op je datawarehouse kun je op twee manieren regelen: je geeft andere systemen een databaseaccount, of je zet er een gecontroleerde laag tussen. Het eerste is snel, maar dan kan elk systeem elke tabel lezen en schrijft iedereen zijn eigen SQL. Het tweede is wat de data-API van ENABLE doet.

Je bepaalt per endpoint welke query er draait, welke parameters zijn toegestaan en hoeveel rijen er maximaal terugkomen. Parameters worden als gebonden waarden aan de database doorgegeven, nooit als tekst in de SQL geplakt. Dat voorkomt SQL-injectie via de URL.

Zo ziet een verzoek eruit

Een systeem doet een GET-verzoek op het adres van het endpoint, met de API-sleutel in de header X-API-Key (of als Bearer-token) en eventuele parameters in de URL. Het antwoord is JSON.

Onderdeel	Inhoud
Adres	/api/v1/queries/[slug], met parameters als ?vanaf=2026-01-01
Sleutel	Header X-API-Key, of Authorization: Bearer
Antwoord: data	De rijen van het resultaat
Antwoord: meta	Aantal rijen, versienummer, afgekapt ja/nee, tijdstip
Foutcodes	401 zonder geldige sleutel, 400 bij een ongeldige parameter, 429 bij te veel verzoeken

Data ontsluiten via API: typische toepassingen

De data-API is bedoeld voor situaties waarin een ander systeem of een script dezelfde cijfers nodig heeft als je dashboards. Een paar voorbeelden:

Andere systemen: een website, CRM of planningstool die dagelijks voorraad, prijzen of KPI's ophaalt.
Maatwerk-apps: apps in het portaal lezen data via goedgekeurde endpoints, vastgezet op een versie van de query.
Automatisering: scripts en integratietools die op vaste momenten een overzicht ophalen en verder verwerken.
AI-assistenten en agents: geef een agent toegang tot één afgebakende query in plaats van tot je hele database.
Eigen dashboards: de databronnen van de dashboard builder (pilot) zijn ook gepubliceerde queries.

Beveiliging en beheer van je endpoints

Alleen klantbeheerders publiceren endpoints. De API-sleutel wordt alleen als hash opgeslagen, dus ook platformbeheer kan hem niet teruglezen; kwijt is vervangen. Een endpoint dat je uitzet, reageert direct niet meer, en wordt een organisatie opgeschort, dan stoppen al haar endpoints.

De rate limit van 60 verzoeken per minuut geldt per endpoint en per IP-adres. Een systeem dat te vaak vraagt, krijgt een 429-antwoord met een wachttijd. Elke uitvoering draait alleen-lezen op je datawarehouse, met dezelfde beveiligde verbinding als de SQL Explorer.

In ENABLE

Zo publiceer je een data API in ENABLE

01
Query schrijven en opslaan
Schrijf en test de query in de SQL Explorer, zelf of met hulp van de AI, en sla hem op onder een herkenbare naam.
02
Endpoint publiceren
Kies de naam in de URL, definieer de parameters met hun type, en stel de rijlimiet en eventuele cache in.
03
Sleutel veilig bewaren
Kopieer de API-sleutel direct naar het systeem dat hem gebruikt. ENABLE toont hem maar één keer.
04
Aanroepen en beheren
Deel de OpenAPI-specificatie met de ontwikkelaar. Publiceer nieuwe versies, zet een oude versie terug of zet het endpoint uit.

Plan een demo Hoe het platform werkt

FAQ

Veelgestelde vragen

Wat is een data API?

Een data API is een vast webadres waarlangs een systeem gegevens opvraagt, zonder zelf in de database te kunnen. In ENABLE is elk endpoint een gepubliceerde, alleen-lezen SQL-query op je eigen datawarehouse, beveiligd met een API-sleutel.

Hoe beveilig ik een API op mijn datawarehouse?

In ENABLE heeft elk endpoint een eigen API-sleutel die alleen als hash wordt bewaard, een vaste query, getypte parameters en een rate limit van 60 verzoeken per minuut per IP-adres. Daarnaast bepaal je zelf de rijlimiet en beperk je de query tot de data die het afnemende systeem mag zien.

Kan ik met de data API ook data wegschrijven?

Nee. De data-API van ENABLE is alleen-lezen: endpoints voeren een SELECT-query uit in een alleen-lezen transactie. Voor het inladen van data in je datawarehouse gebruik je een aparte integratie.

Welke limieten gelden voor de data API?

Per endpoint en IP-adres gelden 60 verzoeken per minuut. Een endpoint geeft standaard maximaal 5.000 rijen terug; je kunt dat per endpoint aanpassen tot 50.000. Het antwoord meldt of het resultaat is afgekapt.

Is er documentatie voor ontwikkelaars?

Ja. ENABLE genereert een OpenAPI 3-specificatie van alle gepubliceerde endpoints van je organisatie, met parameters, types, rijlimieten en de manier van authenticeren. Die kun je importeren in de meeste API-tools.

Veilig delen, snel live, zonder hoofdpijn

In een online demo laten we het portaal zien: dashboards per rol, row-level security, vragen in gewone taal en hoe wij het voor je inrichten en beheren.

Plan een demo info@enableyourdata.nl