API Gateway

Reference AWS API Gateway: REST/HTTP CLI recepty, CORS, JWT auth, řešení problémů 502/504

od itsmostafa · itsmostafa/aws-agent-skills

Funguje s nastavením ★ 7.2/10

API Gateway — Reference AWS API Gateway: REST/HTTP CLI recepty, CORS, JWT auth, řešení problémů 502/504

Co umí

Referenční dovednost pro Amazon API Gateway, která poskytuje CLI recepty pro REST a HTTP API, SAM šablonu, tvar Lambda proxy handleru, konfiguraci CORS pro oba typy API, nastavení JWT autorizátoru a sekci pro řešení problémů pokrývající chyby 403, 502, 504 a CORS. Spouští se, když se zeptáte na vytvoření API Gateway API, propojení Lambda nebo integrace AWS služeb, nastavení autorizátorů, správu fází a nasazení, přidání plánů využití nebo omezení, nebo ladění chybových kódů API Gateway. Součást pluginu aws-agent-skills, který sdružuje 18 dovedností AWS služeb instalovaných dohromady.

Testovací report

Nalezeno skills/api-gateway/SKILL.md přes GitHub tree API (343 řádků, frontmatter má name + description + last_updated 2026-01-07); namátkově načteno integration-patterns.md (HTTP 200) a .claude-plugin/marketplace.json (HTTP 200), které uvádí ./skills/api-gateway, takže cesta instalace je odvoditelná a žádné cesty k počítači nejsou pevně zakódovány; grep pro curl|sh, base64 -d, eval a injekční text nenašel nic. Spouštěcí fráze, které jsem posoudil: MĚLO by se spustit — "Set up an HTTP API in front of my Lambda with a Cognito JWT authorizer" (načíst), "My API Gateway endpoint returns 502 Bad Gateway, help me debug" (načíst), "Add a usage plan and API key throttling to our REST API stage" (načíst); NEMĚLO by se spustit — "Add rate limiting middleware to my Express app running on ECS" (přeskočit), "Design a REST API resource naming scheme for our internal service" (přeskočit); 5/5 správně, kotva "AWS API Gateway" zabraňuje nadměrnému spouštění jinak obecných frází jako "troubleshooting API issues". Pro výstup jsem napsal oba artefakty (apigw-baseline.md vs skillrun.md v scratchpadu) pro jeden úkol: HTTP API POST /orders podporované Lambda, Cognito JWT auth, CORS pro jeden origin. Můj základ pokrýval všech 6 kroků potřebných pro funkční endpoint; striktní dodržování těla SKILL.md pokrylo asi 3 — tělo ukazuje pouze zkratku `create-api --target` pro rychlé vytvoření a nikdy neuvádí příklad `create-route` nebo `create-integration` (`create-route` se objevuje pouze jako jednořádkový záznam v CLI tabulce), nikdy nezmiňuje `--payload-format-version 2.0` a `aws lambda add-permission` se nikde v SKILL.md nebo integration-patterns.md neobjevuje, takže doslovné dodržení nasadí API, které vrací 500. Dovednost přidala dvě věci, které můj základ minul: dekódování těla isBase64Encoded v handleru a poznámky k timeoutu 502 "missing statusCode" / 504 29s-vs-30s. Čistá nula, proto 5/10. Dokumentace snížena na 3: integration-patterns.md není nikdy propojen s SKILL.md, takže progresivní odhalování je mrtvé, příklad instalace Codex v README odkazuje na neexistující dovednost `rlhf` v tomto repozitáři a "deep expertise / real-world patterns, edge cases" přehání to, co je kompetentní, ale neúplný cheat sheet; tvrzení o "18 službách" a týdenních kontrolách dokumentů se shodovala se stromem a .github/workflows/weekly-aws-doc-check.yml.

Testováno: 2026-07-21 · Claude Code 2.x (agent harness)

Instalace

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.

Příkazy a ukázkové prompty

  • /api-gatewayReference AWS API Gateway: REST/HTTP CLI recepty, CORS, JWT auth, řešení problémů 502/504

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

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