HTTPrajapintojen

HTTP-rajapinnat ovat ohjelmistojen välistä yhteydenpitoa mahdollistavia järjestelmiä, jotka kommunikoivat HTTP-protokollan yli. Niiden tarkoituksena on tarjota pääsy resursseihin ja toimintoihin käyttämällä yleisesti hyväksyttyjä HTTP-metodeja, kuten GET, POST, PUT, PATCH ja DELETE. HTTP-rajapintoja voidaan rakentaa eri arkkitehtuurityyleillä, joista yleisimmät ovat REST ja GraphQL sekä RPC-pohjaisia ratkaisuja. Keskeistä on yhteensopivuus erilaisten asiakkaiden kanssa ja selkeä dokumentaatio.

Useimmat HTTP-rajapinnat ovat tilattomia (stateless) ja rakentuvat resurssipohjaiselle ajattelulle, jossa kukin resurssi viitataan omalla URL-osoitteellaan. Vastaukset ovat usein JSON- tai XML-muodossa, ja HTTP-otsikot kuten Content-Type, Accept, Cache-Control ja ETag ohjaavat käsittelyä sekä välimuistia.

Turvallisuus ja hallinta ovat keskeisiä. Useimmat rajapinnat vaativat autentikoinnin ja valtuutuksen, esimerkiksi API-avainten, OAuth 2.0:n tai JWT-tunnusten avulla. Liikenne suojataan TLS- eli HTTPS-yhteyden kautta. CORS-asetukset säätelevät resurssien jakamista verkkosivualustoilta. Yleisiä suunnittelukäytäntöjä ovat versionointi (esim. /v1/), virheenkäsittely sekä pyyntöjen tiheysrajoitus.

RESTin ja GraphQLin välillä valinta määräytyy käyttötapauksen mukaan. REST on laajasti tuettu ja yksinkertainen, kun taas GraphQL tarjoaa joustavan, asiakkaan määriteltävissa olevan tiedonhakumallin. Käyttötapauksina ovat verkkosovellukset, mobiilisovellukset ja mikropalveluarkkitehtuurit. Dokumentointi ja testaus (esim. OpenAPI/Swagger) ovat keskeisiä.