API Gateway
AWS API Gateway referentie: REST/HTTP CLI recepten, CORS, JWT auth, 502/504 probleemoplossing
Werkt met setup
Wat het doet
Een referentieskill voor Amazon API Gateway die CLI-recepten levert voor REST- en HTTP-API's, een SAM-template, Lambda proxy handler-vorm, CORS-configuratie voor beide API-smaken, JWT authorizer-setup, en een probleemoplossingssectie die 403, 502, 504 en CORS-fouten behandelt. Het activeert wanneer u vraagt naar het maken van een API Gateway API, het koppelen van Lambda- of AWS-service-integraties, het instellen van authorizers, het beheren van stages en deployments, het toevoegen van gebruiksabonnementen of throttling, of het debuggen van API Gateway-foutcodes. Onderdeel van de aws-agent-skills plugin, die 18 AWS-service-skills gebundeld installeert.
Testrapport
skills/api-gateway/SKILL.md gevonden via de GitHub tree API (343 regels, frontmatter heeft name + description + last_updated 2026-01-07); steekproefsgewijs integration-patterns.md (HTTP 200) en .claude-plugin/marketplace.json (HTTP 200) opgehaald, die ./skills/api-gateway vermeldt, dus het installatiepad is afleidbaar en geen machinepaden zijn hardgecodeerd; grep naar curl|sh, base64 -d, eval en injectietekst leverde niets op. Triggerzinnen die ik beoordeelde: MOET — "Set up an HTTP API in front of my Lambda with a Cognito JWT authorizer" (laden), "My API Gateway endpoint returns 502 Bad Gateway, help me debug" (laden), "Add a usage plan and API key throttling to our REST API stage" (laden); MOET NIET — "Add rate limiting middleware to my Express app running on ECS" (overslaan), "Design a REST API resource naming scheme for our internal service" (overslaan); 5/5 correct, het "AWS API Gateway" anker voorkomt dat anders generieke zinnen zoals "troubleshooting API issues" te vaak activeren. Voor de output schreef ik beide artefacten (apigw-baseline.md vs skillrun.md in scratchpad) voor één taak: HTTP API POST /orders ondersteund door Lambda, Cognito JWT auth, CORS voor één origin. Mijn baseline omvatte alle 6 stappen die nodig zijn voor een werkend endpoint; het strikt volgen van de SKILL.md body omvatte ongeveer 3 — de body toont alleen de `create-api --target` quick-create shortcut en geeft nooit een `create-route` of `create-integration` voorbeeld (`create-route` verschijnt alleen als een éénregelige rij in een CLI-tabel), vermeldt nooit `--payload-format-version 2.0`, en `aws lambda add-permission` verschijnt nergens in SKILL.md of integration-patterns.md, dus een letterlijke opvolging implementeert een API die 500s. De skill voegde twee dingen toe die mijn baseline miste: isBase64Encoded body-decodering in de handler en de 502 "missing statusCode" / 504 29s-vs-30s timeout-notities. Netto gelijk, vandaar 5/10. Docs afgewaardeerd naar 3: integration-patterns.md is nooit gelinkt vanuit SKILL.md dus progressieve openbaarmaking is dood, het Codex installatievoorbeeld van de README verwijst naar een niet-bestaande `rlhf` skill in deze repo, en "deep expertise / real-world patterns, edge cases" verkoopt te veel wat een competente maar onvolledige cheat sheet is; de "18 services" en wekelijkse doc-check claims kwamen wel overeen met de boomstructuur en .github/workflows/weekly-aws-doc-check.yml.
Getest op: 2026-07-21 · Claude Code 2.x (agent harness)
Installatie
git clone --depth 1 https://github.com/itsmostafa/aws-agent-skills.git /tmp/api-gateway-src mkdir -p ~/.claude/skills cp -R /tmp/api-gateway-src/skills/api-gateway ~/.claude/skills/api-gateway # Plugin instead (installs all 18 AWS skills): /plugin marketplace add itsmostafa/aws-agent-skills # then /plugin install aws-agent-skills # The skill body is pure reference text; the AWS CLI is only needed if you run the commands it shows.
Commando's en voorbeeldprompts
/api-gatewayAWS API Gateway referentie: REST/HTTP CLI recepten, CORS, JWT auth, 502/504 probleemoplossing
Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):
Set up rate limiting on this API GatewayConfigure a Lambda integration for this endpointTroubleshoot this API Gateway 403 error