HTTP API ja REST API

Tervetuloa! AWS API Gateway on tärkeä serverless-sovelluksille. Se toimii taustapalvelujenne ”pääovena”. Mutta mitä API-tyyppiä kannattaa käyttää?

Tässä oppitunnissa vertaillaan REST API - ja HTTP API -rajapintoja. Opitte niiden vahvuudet ja heikkoudet, jotta voitte valita serverless-taustajärjestelmäänne parhaiten sopivan vaihtoehdon.

AWS:n REST API -rajapinnat ovat API Gatewayn alkuperäinen ja monipuolisin rajapintatyyppi. Ne perustuvat REST-arkkitehtuurityyliin ja tarjoavat kattavat hallintamahdollisuudet.

Ajatelkaa niitä kattavana työkalupakkina monimutkaisten API-vuorovaikutusten ja integraatioiden hallintaan.

REST API -rajapinnat tarjoavat edistyneitä ominaisuuksia tarkkaa hallintaa varten:

• Pyyntöjen ja vastausten mappaus: Muuntakaa hyötykuormia Velocity Template Language (VTL) -kielellä.
• Mukautetut valtuuttajat: Toteuttakaa joustava tunnistautuminen Lambda-pohjaisesti tai Cognito user poolin avulla.
• Käyttösuunnitelmat ja throttling: Hallitkaa asiakkaiden API-käyttöä, nopeusrajoja ja kiintiöitä.
• AWS WAF -integraatio: Suojatkaa API-rajapintanne yleisiltä verkkohyökkäyksiltä.
• Reunaverkon optimointi: Käyttäkää globaalia päätepistettä CloudFront-jakelun kanssa latenssin pienentämiseksi.

Valitkaa REST API, kun projektinne edellyttää laajaa mukautettavuutta, edistynyttä tietoturvaa tai monimutkaisia integraatioita:

• Teidän on muunnettava tietomuotoja asiakkaan ja taustajärjestelmän välillä.
• Tarvitsette tarkkarajaisen käyttöoikeuksien hallinnan mukautetulla tunnistautumislogiikalla.
• Haluatte kaupallistaa API-käyttöä tai mitata sitä yksityiskohtaisten suunnitelmien avulla.
• Integroitte vanhoihin järjestelmiin, jotka edellyttävät tietynmuotoisia hyötykuormia.

HTTP API:t ovat uudempi, kevyempi ja kustannustehokkaampi vaihtoehto. Ne on suunniteltu suorituskykyä ja yksinkertaisuutta silmällä pitäen, erityisesti nykyaikaisia palvelimettomia työkuormia varten.

Ne toimivat taustapalvelujesi suoraviivaisena välityspalvelimena keskittyen nopeuteen ja tehokkuuteen.

HTTP API:t sujuvoittavat API Gatewayn käyttöä:

• Pienempi viive: Pyyntöjen käsittely on yleensä nopeampaa kuin REST API:en tapauksessa.
• Pienemmät kustannukset: Kustannukset pyyntöä kohden ovat huomattavasti pienemmät, joten ne ovat erittäin edullisia.
• Suorat integraatiot: Yhdistäminen Lambda-funktioihin ja muihin HTTP-päätepisteisiin sujuu saumattomasti.
• Sisäänrakennetut JWT-valtuuttajat: Helppo integrointi OIDC- ja OAuth 2.0 -palveluntarjoajiin.
• CORS-tuki: Yksinkertainen Cross-Origin Resource Sharing -määritys.

Valitse HTTP API, kun suorituskyky, kustannustehokkuus ja suoraviivaiset integraatiot ovat tärkeimpiä tavoitteitasi:

• Yksinkertaisen ja nopean API-välityspalvelimen rakentaminen Lambda-funktioille.
• Kustannusten kannalta tarkkojen palvelimettomien sovellusten kehittäminen.
• Tarvitset vain perustason JWT-pohjaisen todennuksen.
• Integrointi HTTP-taustajärjestelmiin ilman monimutkaisia tietomuunnoksia.

Tiivistetään keskeiset erot:

• Suorituskyky: HTTP API:t ovat nopeampia ja niiden viive on pienempi.
• Kustannukset: HTTP API:t ovat huomattavasti edullisempia.
• Ominaisuudet: REST API:t tarjoavat kehittyneempiä ominaisuuksia (VTL, WAF, mukautetut valtuuttajat).
• Monimutkaisuus: HTTP API:t on helpompi määrittää ja hallita.
• Käyttötapaukset: REST sopii monimutkaisiin käyttötapauksiin ja HTTP yksinkertaisiin tai suorituskykyä vaativiin käyttötapauksiin.

Hienoa työtä! Ymmärrät nyt AWS API Gatewayn REST API:en ja HTTP API:en keskeiset erot.

Muista ottaa API-tyyppiä valitessasi huomioon projektisi suorituskyky-, kustannus- ja ominaisuusvaatimukset. Molemmat ovat tehokkaita työkaluja palvelimettomassa työkalupakissasi!