Woordenlijst
Wat is REST-API?
Een REST-API is een veelgebruikte vorm van een API die werkt via gewone webverzoeken (HTTP) naar vaste adressen, endpoints genoemd. Het antwoord is meestal JSON.
REST-API uitgelegd
Een REST-API gebruikt de gewone werkwoorden van het web: GET om iets op te halen, POST om iets aan te maken, PUT of PATCH om iets te wijzigen en DELETE om iets te verwijderen. Elk endpoint is een adres, zoals /api/v1/orders, en parameters gaan mee in de URL of in de inhoud van het verzoek.
Het antwoord heeft een statuscode die zegt hoe het ging. 200 betekent gelukt, 401 dat je niet bent geïdentificeerd, 404 dat iets niet bestaat en 429 dat je te veel verzoeken doet. Daardoor kan het aanroepende systeem netjes op fouten reageren.
REST-API's zijn stateless: elk verzoek bevat alles wat nodig is, inclusief de identificatie. Dat maakt ze eenvoudig te schalen en te testen, met tools als curl, Postman of een gewone browser voor GET-verzoeken.
Voorbeeld
Een ontwikkelaar die voor Acme Groothandel werkt, haalt met een GET-verzoek naar /api/v1/queries/open-orders de openstaande orders op, met de API-sleutel in de header. Het antwoord is een JSON-lijst met per order het nummer, de klant en het bedrag.
REST-API in ENABLE
In ENABLE wordt elke gepubliceerde query een REST-endpoint op /api/v1/queries/[slug], aan te roepen met een API-sleutel in de header X-API-Key. Standaard levert een endpoint maximaal 5.000 rijen, instelbaar tot 50.000, en endpoints zijn alleen-lezen.
FAQ
Veelgestelde vragen
Wat betekent REST?
REST staat voor representational state transfer, een stijl voor het bouwen van web-API's met vaste adressen en de gewone HTTP-werkwoorden. Een API die die stijl volgt, heet een REST-API of RESTful API.
Wat is een endpoint?
Een endpoint is een vast adres van een API waar je een bepaald soort gegevens opvraagt of een actie uitvoert. Bijvoorbeeld /api/v1/orders voor een lijst met orders.
Wat is het verschil tussen REST en GraphQL?
Bij REST heeft elk soort gegevens een eigen endpoint met een vast antwoord. Bij GraphQL is er één endpoint en geeft de vrager zelf aan welke velden hij terug wil.
Verder lezen
- PlatformData API: je datawarehouse ontsluiten via RESTPubliceer een query als beveiligd REST-endpoint voor andere systemen en apps.Lees meer
- OplossingAI-agents in je bedrijf: begin bij veilige dataAI-agents beginnen bij veilige, beperkte toegang tot data. Zo legt ENABLE die basis.Lees meer
- PlatformInterne applicatie bouwen op je bedrijfsdataBeschrijf een app in een chat en de AI Builder bouwt hem op je eigen data (pilot). Plus al je andere apps in één hub.Lees meer
- KennisbankWoordenlijst data, AI en Power BIWat is een service principal, row-level security, een semantisch model, text-to-SQL of RAG? Korte, heldere definities van begrippen rond data, Power BI en AI.Lees meer
AI gebruiken op je eigen data. Veilig, en zonder hoofdpijn.
In een online demo laten we zien hoe ENABLE je data veilig beschikbaar maakt en hoe je erop bouwt: een app beschrijven in de AI Builder, vragen in gewone taal, dashboards en API's. En hoe wij het voor je inrichten en beheren.