REST API
Afkorting van Representational State Transfer Application Programming Interface
Wat is een REST API?
Een REST API (ook wel REST-API) is een gestandaardiseerde koppeling tussen systemen via gewone webadressen. Het ene systeem vraagt gegevens op of stuurt ze door, en het andere systeem antwoordt in een vast formaat, meestal JSON.
Veelgestelde vragen over REST API
Moet ik de WordPress REST API uitzetten voor betere beveiliging?
Nee, helemaal uitzetten is een veelgemaakte fout. De blokeditor, veel plugins en apps zoals de WordPress-app gebruiken de REST API. Zet je hem uit, dan werken die onderdelen niet meer goed.
Beperk liever wat openbaar is:
- Verberg gebruikersnamen, bijvoorbeeld met de optie in Wordfence die het opvragen van gebruikersnamen via de REST API blokkeert.
- Gebruik sterke wachtwoorden en tweestapsverificatie.
- Houd WordPress en je plugins up-to-date.
Gevoelige gegevens geeft WordPress standaard alleen aan ingelogde gebruikers met de juiste rechten.
Hoe koppel ik WooCommerce via de REST API aan mijn boekhouding?
Je maakt in WooCommerce een API-sleutel aan waarmee het andere systeem toegang krijgt.
- Ga naar WooCommerce, Instellingen, tabblad Geavanceerd, onderdeel REST API.
- Klik op Sleutel toevoegen, kies een gebruiker en stel de rechten in: lezen, schrijven of lezen/schrijven.
- Kopieer de consumer key en de consumer secret meteen, want het secret zie je maar één keer.
- Vul beide in bij je boekhoudpakket of koppeltool.
Geef nooit meer rechten dan nodig. Voor gewone WordPress-gegevens gebruik je applicatiewachtwoorden onder Gebruikers, Profiel.
Wat kost het om een REST API-koppeling te laten bouwen?
Daar is geen vaste prijs voor, want het hangt sterk af van je situatie. De kosten worden vooral bepaald door:
- Of er al een kant-en-klare koppeling of plugin bestaat.
- Hoe goed de API van het andere systeem beschreven is.
- Of gegevens één kant op gaan of in twee richtingen gesynchroniseerd moeten worden.
- Hoeveel gegevens omgezet moeten worden naar een ander formaat.
- Onderhoud: API's veranderen, dus reken op updates.
Kijk eerst of een koppeltool als Zapier of Make je probleem oplost. Dat is vaak eenvoudiger dan maatwerk.
Wanneer kies ik een webhook in plaats van een REST API?
Kies een webhook als een systeem direct moet reageren op een gebeurtenis, zoals een nieuwe bestelling. Bij een REST API vraagt jouw systeem zelf gegevens op. Bij een webhook stuurt het andere systeem automatisch een bericht zodra er iets gebeurt.
Vuistregel:
- Wil je gegevens opvragen, aanpassen of op vaste momenten ophalen? Gebruik de REST API.
- Wil je meteen een seintje bij een gebeurtenis? Gebruik een webhook.
Vaak werken ze samen: een webhook meldt een nieuwe order en via de REST API haal je daarna de details op. WooCommerce ondersteunt beide.
Wat betekenen foutmeldingen als 401 of 404 bij een API-koppeling?
Het getal is een statuscode die vertelt wat er misging:
- 401: niet geauthenticeerd. Controleer de API-sleutel of het wachtwoord.
- 403: geen toegang. De sleutel heeft te weinig rechten of een beveiligingsplugin blokkeert het verzoek.
- 404: adres niet gevonden. Controleer de URL en sla in WordPress de permalinks opnieuw op via Instellingen, Permalinks.
- 429: te veel verzoeken in korte tijd. Wacht even of verlaag hoe vaak je koppeling gegevens opvraagt.
- 500: fout op de server. Bekijk de foutlogboeken of zet plugins tijdelijk uit om de oorzaak te vinden.
