Je winkelwagen is leeg
Producten die je toevoegt, verschijnen hier.
Een REST API is een manier waarop programma's via het web gegevens uitwisselen: elk stuk informatie heeft een eigen URL, en met gewone HTTP-verzoeken vraag je het op of pas je het aan. REST staat voor Representational State Transfer, een ontwerpstijl die Roy Fielding in 2000 beschreef in zijn proefschrift.
De HTTP-methode zegt wat je wilt. Met GET haal je iets op, met POST maak je iets nieuws, met PUT of PATCH wijzig je het en met DELETE verwijder je het. Elk verzoek staat op zichzelf, want de server onthoudt niets tussen twee verzoeken, dus je stuurt bijvoorbeeld je inloggegevens elke keer mee. Het antwoord komt meestal als JSON, dat vrijwel elke programmeertaal kan lezen.
WordPress laat goed zien hoe het werkt. Open jouwdomein.nl/wp-json/wp/v2/posts in je browser en je krijgt je nieuwste berichten als JSON terug. De blokeditor slaat via dezelfde API op, en apps gebruiken haar om berichten te plaatsen, met een applicatiewachtwoord dat WordPress sinds versie 5.6 kent. Zet de REST API dus niet helemaal uit met een beveiligingsplugin, want dan werkt de editor niet meer. Het oudere XML-RPC doet iets vergelijkbaars, maar via één bestand voor alles en met berichten in XML.
Een REST API werkt op verzoek: jij vraagt en de server antwoordt. Een webhook draait dat om, want daarbij stuurt een dienst jou uit zichzelf een bericht zodra er iets gebeurt. Veel koppelingen gebruiken allebei, zoals een betaaldienst die via een webhook meldt dat een betaling veranderd is, waarna je script de actuele status via de REST API ophaalt.
Geschiedenis
Roy Fielding beschreef REST in 2000 in hoofdstuk 5 van zijn proefschrift aan de University of California, Irvine (Fielding). WordPress kreeg zijn eigen REST API in twee stappen, eerst de basis en een jaar later de endpoints voor content.
Belangrijke mijlpalen:
- 2000: Roy Fielding definieert REST in zijn proefschrift
- December 2015: WordPress 4.4 neemt de basis van de REST API op (WordPress 4.4)
- December 2016: WordPress 4.7 voegt endpoints toe voor berichten, reacties, gebruikers en meer (WordPress 4.7)
- December 2020: WordPress 5.6 introduceert applicatiewachtwoorden voor de REST API (Make WordPress)
Bronnen
- Roy Fielding (2000) - Architectural Styles and the Design of Network-based Software Architectures, hoofdstuk 5
- MDN Web Docs - REST
- WordPress.org - REST API Handbook
- WordPress.org - REST API Reference: Posts
- Wikipedia - REST