API Gateway

AWS API Gateway-referens: REST/HTTP CLI-recept, CORS, JWT-autentisering, 502/504 felsökning

av itsmostafa · itsmostafa/aws-agent-skills

Fungerar med konfiguration ★ 7.2/10

API Gateway — AWS API Gateway-referens: REST/HTTP CLI-recept, CORS, JWT-autentisering, 502/504 felsökning

Vad den gör

En referensfärdighet för Amazon API Gateway som tillhandahåller CLI-recept för REST- och HTTP-API:er, en SAM-mall, Lambda proxy handler-form, CORS-konfiguration för båda API-typerna, JWT-authorizer-konfiguration och en felsökningssektion som täcker 403, 502, 504 och CORS-fel. Den utlöses när du frågar om att skapa ett API Gateway API, koppla Lambda- eller AWS-tjänstintegrationer, konfigurera authorizers, hantera steg och distributioner, lägga till användningsplaner eller throttling, eller felsöka API Gateway-felkoder. Del av aws-agent-skills-pluginen, som buntar 18 AWS-tjänstfärdigheter installerade tillsammans.

Testrapport

Hittade skills/api-gateway/SKILL.md via GitHub tree API (343 rader, frontmatter har name + description + last_updated 2026-01-07); stickprovshämtade integration-patterns.md (HTTP 200) och .claude-plugin/marketplace.json (HTTP 200), som listar ./skills/api-gateway, så installationssökvägen är härledbar och inga maskinsökvägar är hårdkodade; grep efter curl|sh, base64 -d, eval och injektionstext hittade ingenting. Trigger-fraseringar jag bedömde: SKA — "Set up an HTTP API in front of my Lambda with a Cognito JWT authorizer" (ladda), "My API Gateway endpoint returns 502 Bad Gateway, help me debug" (ladda), "Add a usage plan and API key throttling to our REST API stage" (ladda); SKA INTE — "Add rate limiting middleware to my Express app running on ECS" (hoppa över), "Design a REST API resource naming scheme for our internal service" (hoppa över); 5/5 korrekta, "AWS API Gateway"-ankaret hindrar de annars generiska fraserna som "troubleshooting API issues" från att överutlösas. För utdata skrev jag båda artefakterna (apigw-baseline.md vs skillrun.md i scratchpad) för en uppgift: HTTP API POST /orders backad av Lambda, Cognito JWT auth, CORS för en origin. Min baslinje täckte alla 6 steg som behövdes för en fungerande endpoint; att strikt följa SKILL.md:s brödtext täckte cirka 3 — brödtexten visar endast `create-api --target` snabbgenvägen och ger aldrig ett `create-route` eller `create-integration`-exempel (`create-route` visas endast som en enradig rad i en CLI-tabell), nämner aldrig `--payload-format-version 2.0`, och `aws lambda add-permission` förekommer ingenstans i SKILL.md eller integration-patterns.md, så en bokstavlig följd distribuerar ett API som returnerar 500. Skickligheten lade till två saker som min baslinje missade: isBase64Encoded body decoding i handlern och 502 "missing statusCode" / 504 29s-vs-30s timeout-anteckningarna. Netto noll, därav 5/10. Dokumentationen sänktes till 3: integration-patterns.md är aldrig länkad från SKILL.md så progressiv upplysning är död, README:s Codex-installations exempel pekar på en icke-existerande `rlhf`-skicklighet i detta repo, och "deep expertise / real-world patterns, edge cases" överdriver vad som är en kompetent men ofullständig fusklapp; påståendena om "18 services" och veckovisa dokumentkontroller stämde överens med trädet och .github/workflows/weekly-aws-doc-check.yml.

Testad: 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.

Kommandon och exempelprompter

  • /api-gatewayAWS API Gateway-referens: REST/HTTP CLI-recept, CORS, JWT-autentisering, 502/504 felsökning

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

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