Endpointeja

Endpointeja on suomenkielinen termi, joka viittaa ohjelmistojärjestelmän tai verkkopalvelun rajapinnan yhteyspisteisiin. Ne ovat paikkoja, joihin asiakkaat, sovellukset tai muut järjestelmät voivat ottaa yhteyden ja suorittaa toimintoja tai hakea tietoja. Yleisimmässä käytössä endpointeja tarkastellaan yhdessä resurssien kanssa, ja niihin liittyy usein URL-osoite sekä käytettävä protokolla ja sanomat (esimerkiksi HTTP ja REST-menetelmät).

REST-rajapinnoissa endpointeja käytetään resursseihin viittaamiseen. Esimerkki voisi olla GET https://api.esimerkki.fi/v1/kayttajat/123, jolla haetaan käyttäjäresurssi. GraphQL-rajapinnoilla puolestaan on usein yksi pääendpoint (esimerkiksi /graphql), johon lähetetään kyselyt ja mutaatiot. SOAP-rajapinnat määritellään WSDL-dokumentissa, ja niihin liittyy usein erillisiä palvelun lopetuspisteitä. Mikroarkkitehtuureissa endpointeja voivat olla myös palveluiden verkko-osoitteet, joita käytetään palveluiden välillä tapahtuvaan kommunikaatioon.

Suunnittelussa endpointeja kannattaa lähestyä resurssikeskeisesti: nimeäminen tulisi olla substantiivien mukaista, menetelmät (GET, POST, PUT, DELETE tms.) määrittävät toimet, eikä URL:iin tulisi sotkea liikaa verbejä. Versionointi (esim. /v1/) helpottaa muutoksia, kun vanhoja toimintoja säilytetään. Turvallisuus, autentikointi ja virheenkäsittely sekä hyvän dokumentaation ja discoverabilityn huomioiminen ovat olennaisia.

Endpointeja käsitellään myös laajemmin palveluiden välisessä kommunikaatiossa ja service discoveryssä, jolloin ne osoittavat, miten eri komponentit löytävät toisensa verkossa.