API Gateway

AWS API Gateway reference: REST/HTTP CLI-opskrifter, CORS, JWT-autentificering, 502/504 fejlfinding

Af itsmostafa · itsmostafa/aws-agent-skills

Virker med opsætning ★ 7.2/10

API Gateway — AWS API Gateway reference: REST/HTTP CLI-opskrifter, CORS, JWT-autentificering, 502/504 fejlfinding

Hvad det gør

En reference-skill til Amazon API Gateway, der leverer CLI-opskrifter til REST- og HTTP-API'er, en SAM-skabelon, Lambda proxy handler-form, CORS-konfiguration for begge API-typer, JWT-autorisationsopsætning og en fejlfindingssektion, der dækker 403, 502, 504 og CORS-fejl. Den udløses, når du spørger om at oprette en API Gateway API, forbinde Lambda- eller AWS-serviceintegrationer, opsætte autorisatorer, administrere stadier og deployments, tilføje brugsplaner eller throttling eller fejlfinde API Gateway-fejlkoder. En del af aws-agent-skills-plugin'en, som samler 18 AWS-service-skills installeret sammen.

Testrapport

Fandt skills/api-gateway/SKILL.md via GitHub tree API (343 linjer, frontmatter har name + description + last_updated 2026-01-07); spot-hentede integration-patterns.md (HTTP 200) og .claude-plugin/marketplace.json (HTTP 200), som lister ./skills/api-gateway, så installationsstien kan udledes, og ingen maskinstier er hardkodede; grep efter curl|sh, base64 -d, eval og injektionstekst fandt intet. Trigger-fraseringer, jeg bedømte: SKAL — "Set up an HTTP API in front of my Lambda with a Cognito JWT authorizer" (indlæs), "My API Gateway endpoint returns 502 Bad Gateway, help me debug" (indlæs), "Add a usage plan and API key throttling to our REST API stage" (indlæs); SKAL IKKE — "Add rate limiting middleware to my Express app running on ECS" (spring over), "Design a REST API resource naming scheme for our internal service" (spring over); 5/5 korrekt, "AWS API Gateway" ankeret forhindrer de ellers generiske fraser som "troubleshooting API issues" i at over-udløse. For output skrev jeg begge artefakter (apigw-baseline.md vs skillrun.md i scratchpad) for én opgave: HTTP API POST /orders understøttet af Lambda, Cognito JWT auth, CORS for én origin. Min baseline dækkede alle 6 trin, der var nødvendige for et fungerende endpoint; at følge SKILL.md-kroppen strengt dækkede omkring 3 — kroppen viser kun `create-api --target` quick-create genvejen og giver aldrig et `create-route` eller `create-integration` eksempel (`create-route` vises kun som en enkeltlinje i en CLI-tabel), nævner aldrig `--payload-format-version 2.0`, og `aws lambda add-permission` vises ingen steder i SKILL.md eller integration-patterns.md, so a literal follow deploys an API that 500s. Skill'en tilføjede to ting, min baseline missede: isBase64Encoded body-dekodning i handleren og 502 "missing statusCode" / 504 29s-vs-30s timeout-noter. Netto nul, deraf 5/10. Docs trukket til 3: integration-patterns.md er aldrig linket fra SKILL.md, så progressiv afsløring er død, README's Codex-installations eksempel peger på en ikke-eksisterende `rlhf` skill i dette repo, og "deep expertise / real-world patterns, edge cases" oversælger, hvad der er en kompetent, men ufuldstændig snydeark; påstandene om "18 services" og ugentlig dok-kontrol stemte overens med træet og .github/workflows/weekly-aws-doc-check.yml.

Testet: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

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.

Kommandoer og eksempelprompter

  • /api-gatewayAWS API Gateway reference: REST/HTTP CLI-opskrifter, CORS, JWT-autentificering, 502/504 fejlfinding

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):

  • Set up rate limiting on this API Gateway
  • Configure a Lambda integration for this endpoint
  • Troubleshoot this API Gateway 403 error