Palvelupäätepiste

Palvelupäätepiste (service endpoint) on järjestelmän tai palvelun osoituspaikka, jonka kautta asiakkaat voivat käyttää tarjottuja toimintoja. Se muodostaa käytettävän rajapinnan ja voi viitata REST-, gRPC-, SOAP- tai muun protokollan kautta tarjottaviin palveluihin. Palvelupäätepisteessa määritellään sekä sijainti (esimerkiksi verkkosoite) että käytettävä protokolla sekä siihen liittyvä sopimus tai rajapintadiaknoosi. Päätepiste voi olla julkinen, yksityinen tai sen välillä olla hallinnoitu suojaus ja pääsy.

Päätepisteen keskeiset ominaisuudet ja osat ovat: verkko-osoite (URL/URI), käytetty protokolla (HTTP/HTTPS, gRPC, AMQP jne.), turvallisuusvaatimukset (tunnistaminen, salaus, valtuutus), sekä sopimus tai rajapintakuvailu (API-specifikaatio kuten OpenAPI) ja versiokäytännöt. Päätepiste voi olla yksittäinen päätepiste tai ryhmä päätepisteitä, jotka jakaantuvat kuormituksenhallinnan, palvelujen skaalauksen ja haavoittuvuuksien hallinnan vuoksi. Se voi sijaita API-gatewayn, kuormalaskurin tai ohjauskerroksen takana ja olla dynamisesti löydettävissä palvelunetsintärekisterin avulla.

Käyttökonteksteja ovat esimerkiksi REST-rajapinnat, joissa käyttäjät voivat tehdä operaatioita resurssille (esimerkiksi GET /v1/users), sekä gRPC- tai SOAP-päätepisteet, joita kutsutaan ohjelmallisesti ohjelmistojen välillä. Päätepisteiden hallinta käsittää niiden dokumentoinnin, versioningin, deprekoinnin sekä turvallisuuden ja käytettävyyden seurannan. Muutokset päätepisteisiin voivat vaatia yhteensopivuus- ja migraatiaskeleita.