Egendefinerte domenenavn og edge-optimalisering

Når du distribuerer en API Gateway-API, oppgir AWS en standard-URL. Den ser omtrent slik ut: https://abcdef123.execute-api.us-east-1.amazonaws.com/prod.

Selv om denne URL-en fungerer, er den ikke særlig brukervennlig eller egnet for merkevarebygging. I denne leksjonen viser vi hvordan du kan bruke ditt eget domenenavn!

Alle API Gateway-API-er får automatisk en unik endepunkt-URL. Denne URL-en inneholder en tilfeldig ID, AWS-regionen og amazonaws.com.

• Eksempel: https://{restapi_id}.execute-api.{region}.amazonaws.com/{stage_name}
• Den fungerer umiddelbart etter distribusjon.
• Flott for testing, men ikke ideell for API-er som er tilgjengelige for offentligheten.

Det gir flere fordeler å bruke et egendefinert domenenavn for API-et:

• Merkevarebygging: Bruk bedriftens domene, for eksempel api.yourcompany.com.
• Lettere å huske: Det blir enklere for brukere og utviklere å huske og skrive inn adressen.
• Fleksibilitet: Du kan endre backend-API-et uten å endre den offentlige URL-en.
• SEO (for web-API-er): Bidrar til søkemotoroptimalisering.

Før du kan bruke et egendefinert domene, trenger du et SSL/TLS-sertifikat. Sertifikatet krypterer kommunikasjonen og bekrefter identiteten til API-et.

• AWS Certificate Manager (ACM) kan opprette gratis offentlige SSL-sertifikater.
• Du kan også importere ditt eget sertifikat.
• For kantoptimaliserte API-er må sertifikatet være i regionen US East (N. Virginia).

Når du har et SSL-sertifikat, kan du konfigurere det egendefinerte domenet i API Gateway-konsollen.

Du angir domenenavnet, for eksempel api.example.com, og knytter det til ACM-sertifikatet. API Gateway oppretter deretter et domenenavn og oppgir et DNS-mål (et domenenavn for en CloudFront-distribusjon).

Et egendefinert domene må vite hvilket API Gateway-API forespørsler skal rutes til. Dette gjøres ved hjelp av tilordninger for basisbane.

Du definerer en basisbane, for eksempel /v1 eller /, og tilordner den til et bestemt API Gateway-API og en scene, for eksempel prod.

• api.example.com/v1 -> my-api/prod
• api.example.com/users -> users-api/prod

Det siste trinnet er å oppdatere DNS-postene for domenet ditt. Du må opprette en CNAME-post (eller en A-post hvis du bruker et Route 53-alias) som peker fra det egendefinerte domenet til DNS-målet som API Gateway har oppgitt.

Dette forteller internett at forespørsler til api.example.com skal gå til API Gateways CloudFront-distribusjon.

API Gateway tilbyr ulike typer endepunkter. Kantoptimaliserte endepunkter er standard for REST-API-er og er utviklet for globale klienter.

De bruker Amazon CloudFront, AWS sitt innholdsleveringsnettverk (CDN), til å rute forespørsler via det nærmeste kantlokasjonen til brukerne dine.

Dette reduserer forsinkelsen og forbedrer ytelsen for klienter som er geografisk spredt.

Når du bruker et kantoptimalisert endepunkt:

1. Forespørselen fra en bruker treffer den nærmeste CloudFront-kantlokasjonen.
2. CloudFront videresender forespørselen til API Gateway i AWS-regionen.
3. Svaret bufres ved kantlokasjonen (hvis dette er konfigurert), og returneres til brukeren.

Bufringen og rutingen basert på nærhet gjør API-kall betydelig raskere for brukere over hele verden.

API Gateway støtter også regionale endepunkter. Disse passer best når alle API-konsumentene befinner seg i samme AWS-region som API-et.

• Kantoptimalisert: Standard for REST-API-er, bruker CloudFront og passer best for globale brukere.
• Regionalt: Passer best for klienter i samme region. Du kan plassere din egen CloudFront-distribusjon foran endepunktet for å få mer kontroll.

HTTP-API-er støtter som standard bare regionale endepunkter, men du kan legge til CloudFront selv.

I denne leksjonen lærte vi hvordan du kan gi API Gateway-API-ene dine et profesjonelt uttrykk med tydelig merkevareprofil ved hjelp av egendefinerte domenenavn. Vi gikk gjennom trinnene fra SSL-sertifikater til DNS-konfigurasjon.

Vi utforsket også kantoptimaliserte endepunkter og så hvordan de utnytter CloudFront til å levere API-et ditt med lav forsinkelse til brukere over hele verden. Nå vet du når du bør velge mellom kantoptimaliserte og regionale endepunkter.