endpoint
/ˈɛndˌpɔɪnt/zelfstandig naamwoord
Een endpoint is een adres waarop een API een bepaalde gegevensbron of handeling beschikbaar stelt.
De mobiele app vraagt de actuele voorraad op bij het endpoint voor producten.
Een endpoint is een specifiek toegangspunt van een Woordenboek · In het kortAPIEen API is een vastgelegde manier waarop software gegevens uitwisselt of functies van andere software aanroept, zonder de interne werking daarvan te hoeven kennen.Lees meer. Een toepassing stuurt een verzoek naar dat adres om gegevens op te vragen, toe te voegen, te wijzigen of te verwijderen. Bij web-API's is een endpoint meestal gebaseerd op een URL, bijvoorbeeld een adres voor alle bestellingen of voor één specifieke bestelling.
Waaruit bestaat een endpoint?
Bij een HTTP-API bestaat een endpoint vaak uit de combinatie van een webadres en een methode. Dezelfde URL kan daardoor verschillende handelingen ondersteunen. Een GET-verzoek kan gegevens ophalen, terwijl een POST-verzoek naar hetzelfde adres nieuwe gegevens toevoegt.
De API legt ook vast welke informatie het verzoek moet bevatten en welk antwoord de aanvrager kan verwachten. Denk aan verplichte velden, het formaat van het antwoord en mogelijke foutmeldingen. Vaak controleert het endpoint via Woordenboek · In het kortauthenticatieAuthenticatie is het proces waarmee een systeem de opgegeven identiteit van een gebruiker, apparaat of applicatie controleert.Lees meer wie het verzoek doet en of die partij toegang heeft.
Endpoint, route en API
De termen endpoint en route worden soms door elkaar gebruikt. Een route is meestal de regel in de servercode die een bepaald pad en een bepaalde methode afhandelt. Het endpoint is de plek die een andere toepassing daadwerkelijk kan benaderen. In de praktijk wijzen beide vaak naar dezelfde combinatie van methode en adres.
Een API bestaat meestal uit meerdere endpoints. Een webshop kan bijvoorbeeld aparte endpoints hebben voor producten, klanten en bestellingen. Samen vormen ze de afspraken waarmee andere software met de webshop communiceert. Eén endpoint is dus een afzonderlijk onderdeel van de volledige API.