Aangepaste domeinnamen en edge-optimalisatie

Wanneer je een API Gateway-API implementeert, geeft AWS je een standaard-URL. Die ziet er ongeveer zo uit: https://abcdef123.execute-api.us-east-1.amazonaws.com/prod.

Hoewel deze URL functioneel is, is hij niet erg gebruiksvriendelijk en draagt hij weinig bij aan je merk. In deze les leer je hoe je je eigen domeinnaam gebruikt!

Elke API Gateway-API krijgt automatisch een unieke eindpunt-URL. Deze URL bevat een willekeurige ID, de AWS-regio en amazonaws.com.

• Voorbeeld: https://{restapi_id}.execute-api.{region}.amazonaws.com/{stage_name}
• De URL werkt meteen nadat je de API hebt geïmplementeerd.
• Handig voor tests, maar niet ideaal voor API's die openbaar toegankelijk zijn.

Een aangepaste domeinnaam voor je API biedt verschillende voordelen:

• Merkidentiteit: Gebruik het domein van je bedrijf, bijvoorbeeld api.yourcompany.com.
• Onthoudbaarheid: Gebruikers en ontwikkelaars kunnen de URL gemakkelijker onthouden en typen.
• Flexibiliteit: Je kunt je backend-API wijzigen zonder de openbare URL te wijzigen.
• SEO (voor web-API's): Helpt bij zoekmachineoptimalisatie.

Voordat je een aangepast domein kunt gebruiken, heb je een SSL/TLS-certificaat nodig. Dit certificaat versleutelt de communicatie en bewijst de identiteit van je API.

• AWS Certificate Manager (ACM) kan gratis openbare SSL-certificaten uitgeven.
• Je kunt ook je eigen certificaat importeren.
• Voor edge-geoptimaliseerde API's moet het certificaat zich in de regio US East (N. Virginia) bevinden.

Zodra je een SSL-certificaat hebt, kun je je aangepaste domein configureren in de API Gateway-console.

Je geeft je domeinnaam op, bijvoorbeeld api.example.com, en koppelt die aan het ACM-certificaat. API Gateway maakt vervolgens een domeinnaam aan en geeft een DNS-doel op, namelijk een CloudFront-distributiedomeinnaam.

Een aangepast domein moet weten naar welke API Gateway-API aanvragen moeten worden doorgestuurd. Dit doe je met basispadkoppelingen.

Je definieert een basispad, bijvoorbeeld /v1 of /, en koppelt dit aan een specifieke API Gateway-API en fase, bijvoorbeeld prod.

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

De laatste stap is het bijwerken van de DNS-records van je domein. Je moet een CNAME-record maken, of een A-record als je een Route 53-alias gebruikt, dat je aangepaste domein verwijst naar het DNS-doel dat API Gateway heeft opgegeven.

Hiermee geef je op internet aan dat aanvragen voor api.example.com naar de CloudFront-distributie van API Gateway moeten gaan.

API Gateway biedt verschillende typen eindpunten. Edge-geoptimaliseerde eindpunten zijn de standaard voor REST-API's en zijn ontworpen voor gebruikers over de hele wereld.

Ze gebruiken Amazon CloudFront, het contentdistributienetwerk (CDN) van AWS, om aanvragen via de dichtstbijzijnde edge-locatie naar je gebruikers te routeren.

Dit vermindert de vertraging en verbetert de prestaties voor gebruikers die geografisch verspreid zijn.

Wanneer je een edge-geoptimaliseerd eindpunt gebruikt:

1. De aanvraag van een gebruiker komt binnen bij de dichtstbijzijnde CloudFront-edge-locatie.
2. CloudFront stuurt de aanvraag door naar je API Gateway in de AWS-regio.
3. Het antwoord wordt opgeslagen in de edge-locatie, als dit is geconfigureerd, en naar de gebruiker teruggestuurd.

Door deze caching en routering op basis van nabijheid worden API-aanroepen voor gebruikers overal ter wereld aanzienlijk sneller.

API Gateway ondersteunt ook regionale eindpunten. Deze zijn het meest geschikt wanneer al je API-gebruikers zich in dezelfde AWS-regio bevinden als je API.

• Edge-geoptimaliseerd: Standaard voor REST-API's, gebruikt CloudFront en is het meest geschikt voor gebruikers overal ter wereld.
• Regionaal: Het meest geschikt voor gebruikers in dezelfde regio; je kunt er je eigen CloudFront-distributie vóór plaatsen voor meer controle.

HTTP-API's ondersteunen standaard alleen regionale eindpunten, maar je kunt zelf CloudFront toevoegen.

In deze les hebben we geleerd hoe je API Gateway-API's met aangepaste domeinnamen een professionele uitstraling en een herkenbare merkidentiteit geeft. We hebben de stappen behandeld van SSL-certificaten tot DNS-configuratie.

We hebben ook edge-geoptimaliseerde eindpunten bekeken en geleerd hoe ze CloudFront gebruiken om je API met weinig vertraging aan gebruikers overal ter wereld te leveren. Je weet nu wanneer je moet kiezen voor edge-geoptimaliseerde of regionale eindpunten.