Anpassade domännamn och edge-optimering

När Ni distribuerar ett API Gateway-API tillhandahåller AWS en standard-URL. Den ser ut ungefär så här: https://abcdef123.execute-api.us-east-1.amazonaws.com/prod.

Även om URL:en fungerar är den inte särskilt användarvänlig eller lämplig för varumärkesbyggande. I den här lektionen får Ni lära Er att använda Ert eget domännamn!

Varje API Gateway-API får automatiskt en unik slutpunkts-URL. Den här URL:en innehåller ett slumpmässigt ID, AWS-regionen och amazonaws.com.

• Exempel: https://{restapi_id}.execute-api.{region}.amazonaws.com/{stage_name}
• Den fungerar direkt efter distributionen.
• Utmärkt för testning, men inte idealisk för publika API:er.

Att använda ett anpassat domännamn för Ert API ger flera fördelar:

• Varumärkesprofilering: Använd företagets domän, till exempel api.yourcompany.com.
• Kom­ihåg-vänlighet: Enklare för användare och utvecklare att komma ihåg och skriva in.
• Flexibilitet: Ni kan ändra backend-API:et utan att ändra den publika URL:en.
• SEO (för webb-API:er): Bidrar till sökmotoroptimering.

Innan Ni kan använda en anpassad domän behöver Ni ett SSL/TLS-certifikat. Certifikatet krypterar kommunikationen och bekräftar API:ets identitet.

• AWS Certificate Manager (ACM) kan utfärda kostnadsfria publika SSL-certifikat.
• Ni kan även importera ett eget certifikat.
• För edge-optimerade API:er måste certifikatet finnas i regionen US East (N. Virginia).

När Ni har ett SSL-certifikat kan Ni konfigurera den anpassade domänen i API Gateway-konsolen.

Ni anger domännamnet, till exempel api.example.com, och kopplar det till ACM-certifikatet. API Gateway skapar sedan ett domännamn och tillhandahåller ett DNS-mål (ett CloudFront-distributionsdomännamn).

En anpassad domän måste veta vilket API Gateway-API som förfrågningar ska dirigeras till. Detta görs med hjälp av mappningar för bassökvägar.

Ni definierar en bassökväg, till exempel /v1 eller /, och mappar den till ett specifikt API Gateway-API och en stage, till exempel prod.

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

Det sista steget är att uppdatera DNS-posterna för Er domän. Ni behöver skapa en CNAME-post (eller en A-post om Ni använder ett Route 53-alias) som pekar från den anpassade domänen till det DNS-mål som API Gateway tillhandahåller.

Detta talar om för internet att förfrågningar till api.example.com ska gå till API Gateways CloudFront-distribution.

API Gateway erbjuder olika typer av slutpunkter. Edge-optimerade slutpunkter är standard för REST-API:er och är utformade för globala klienter.

De använder Amazon CloudFront, AWS:s nätverk för innehållsleverans (CDN), för att dirigera förfrågningar via den närmaste edge-platsen till Era användare.

Detta minskar fördröjningen och förbättrar prestandan för klienter som är geografiskt utspridda.

När Ni använder en edge-optimerad slutpunkt:

1. En användares förfrågan når den närmaste CloudFront-edge-platsen.
2. CloudFront vidarebefordrar förfrågan till Ert API Gateway i AWS-regionen.
3. Svaret cachas på edge-platsen, om detta har konfigurerats, och skickas tillbaka till användaren.

Denna cachning och dirigering baserad på närhet snabbar avsevärt upp API-anrop för användare över hela världen.

API Gateway stöder även regionala slutpunkter. Dessa passar bäst när alla Era API-konsumenter finns i samma AWS-region som API:et.

• Edge-optimerad: Standard för REST-API:er, använder CloudFront och passar bäst för användare över hela världen.
• Regional: Passar bäst för klienter i samma region och kan placeras bakom Er egen CloudFront-distribution för större kontroll.

HTTP-API:er stöder som standard endast regionala slutpunkter, men Ni kan lägga till CloudFront själva.

I den här lektionen lärde Ni Er hur Ni kan ge Era API Gateway-API:er ett professionellt och varumärkesanpassat utseende med hjälp av anpassade domännamn. Vi gick igenom stegen från SSL-certifikat till DNS-konfiguration.

Vi undersökte även edge-optimerade slutpunkter och hur de använder CloudFront för att leverera Ert API med låg fördröjning till användare över hela världen. Nu vet Ni när Ni bör välja mellan edge-optimerade och regionala slutpunkter.