Ein Endpunkt ist eine bestimmte Adresse einer Programmierschnittstelle, unter der eine Funktion oder eine Art von Daten erreichbar ist. Eine Schnittstelle besteht meist aus vielen Endpunkten, etwa einem für Kunden, einem für Bestellungen und einem für Rechnungen.
- Endpunkt
Eine Adresse einer Schnittstelle, die zusammen mit einer HTTP-Methode eine bestimmte Funktion auslöst.
Beispiel: „Für neue Anfragen aus dem Kontaktformular gibt es einen eigenen Endpunkt, der die Daten ans CRM weiterreicht.“Auch: API-Endpoint oder Endpoint.
Verwandt: URL, die Adresse, unter der ein Endpunkt erreichbar ist.
Wie ein Endpunkt aufgebaut ist
Aus einer Basisadresse, etwa https://api.beispiel.de/v1, und einem Pfad wie /kunden/42. Zusammen mit der HTTP-Methode ergibt das die eigentliche Funktion: GET /kunden/42 liest einen Kunden, DELETE /kunden/42 löscht ihn.
Zusätzliche Angaben stehen im Query String, etwa ?seite=2 für die zweite Seite einer Liste, oder im Body der Anfrage.
Wie Endpunkte benannt werden
In einer REST-API nach den Dingen, um die es geht, in der Mehrzahl und ohne Verben: /bestellungen statt /holeBestellungen. Was passieren soll, sagt die Methode.
Einheitliche Namen sparen später viel Zeit. Wer weiß, dass es /kunden gibt, vermutet /lieferanten richtig, ohne in die Dokumentation zu sehen.
Endpunkte im Framework
In einem Framework wie Laravel, Slim oder Express.js ist ein Endpunkt eine Route, die einer Adresse und einer Methode eine Funktion zuordnet. Jeder öffentlich erreichbare Endpunkt sollte geprüft werden: Wer darf ihn aufrufen, wie oft, und mit welchen Daten?
Für KI-Modelle hat sich der Begriff ebenfalls eingebürgert: Ein Modell-Endpunkt ist die Adresse, unter der ein Anbieter ein Sprachmodell zum Aufruf bereitstellt.