Wat is het verschil tussen een endpoint en een gewone URL?
Technisch is er geen verschil: een endpoint ís een URL. Het verschil zit in waar het antwoord voor bedoeld is.
Een gewone URL levert een pagina voor een mens. Een endpoint levert gegevens voor software.
Daar volgen een paar praktische verschillen uit.
Wat je terugkrijgt
Bij een pagina krijg je HTML met opmaak, afbeeldingen en navigatie. Bij een endpoint krijg je kale gegevens, meestal in JSON.
Geen kopteksten, geen menu, geen vormgeving. Meer daarover lees je bij json.
Hoe je hem aanroept
Een pagina open je door hem te bezoeken. Een endpoint kun je ook aanroepen met een werkwoord dat iets wijzigt of aanmaakt.
Dat kan een browser niet zomaar; daar is software voor nodig.
Waar het praktisch uitmaakt
Endpoints horen niet in je sitemap en niet in Google. Ze zijn niet bedoeld om gevonden te worden.
Ook wil je ze niet cachen zoals je pagina’s cachet; dan krijgt de volgende aanvrager verouderde gegevens. Meer daarover lees je bij cache.
Mijn vuistregels
- Houd endpoints uit je sitemap.
- Cache ze anders dan je pagina’s, of helemaal niet.
- Verwacht geen nette foutpagina; je krijgt een code en een regel tekst.
- Test ze met een hulpmiddel, niet met je browser.
Die tweede is de oorzaak van veel vreemde koppelingsproblemen.
Waarom sommige toch in je browser werken
Endpoints die alleen gegevens ophalen en geen sleutel vragen, kun je gewoon openen. Je ziet dan ruwe tekst.
Dat is handig om te controleren of iets werkt, maar het zegt niets over de rest van de koppeling.
Bij WordPress
Je site heeft een reeks endpoints onder een vast pad. Open er een en je ziet je berichten als kale gegevens.
Meer daarover lees je bij wat een endpoint is.