Wat is een endpoint?

Een endpoint is het adres waar één specifieke vraag aan een systeem gesteld wordt. Geef de producten, maak een bestelling aan, verstuur deze order.

Een koppeling bestaat uit meerdere endpoints, elk met een eigen taak. Samen vormen ze de programmeerinterface.

Je herkent ze aan een adres dat er niet uitziet als een gewone pagina.

Hoe zo’n adres eruitziet

Bijvoorbeeld een adres dat eindigt op producten, of op orders met een nummer erachter. Het pad zegt wat je vraagt.

Daarbij hoort een werkwoord: ophalen, aanmaken, wijzigen of verwijderen. Meer daarover lees je bij api.

Wat je terugkrijgt

Geen webpagina maar gestructureerde gegevens, meestal in JSON. Dat is bedoeld om door software gelezen te worden, niet door mensen.

Meer daarover lees je bij json.

Waar je ze tegenkomt

Bij elke koppeling: je boekhoudpakket, je verzendpartij, je betaalprovider, je nieuwsbriefdienst.

Ook WordPress zelf heeft er een hele reeks, waarmee je vanaf buiten je site kunt uitlezen en bijwerken.

Mijn vuistregels

1. Eén endpoint doet één ding; verwacht niet dat er één is die alles kan.
2. Lees de documentatie voordat je gaat proberen.
3. Test eerst op een testomgeving van de aanbieder.
4. Bewaar je sleutels niet in je code.

Die laatste is de meest gemaakte beveiligingsfout in koppelingen.

Waarom het je iets aangaat

Omdat vrijwel elke koppeling die je laat bouwen hierop neerkomt, en omdat de kosten ervan hier bepaald worden.

Een dienst met heldere endpoints koppelen kost uren. Een dienst zonder documentatie kost dagen. Meer daarover lees je bij hoe je het juiste endpoint vindt.

Wat het niet is

Geen pagina die je in je browser bekijkt, al kun je sommige endpoints wel gewoon openen.

Meer daarover lees je bij het verschil tussen een endpoint en een gewone URL.

Veelgestelde vragen hierover