The API Handbook skill guides developers in designing production-ready HTTP APIs and Next.js Route Handlers across Node and Edge runtimes. It establishes clear architectural boundaries between Route Handlers, Server Actions, and webhook receivers while prescribing standard resource-oriented URL paths, consistent HTTP status codes, structured JSON error responses, and boundary validation using Zod. By integrating idempotency key conventions, explicit CORS rules, and secure authorization checks, this skill ensures backend endpoints remain predictable, secure, and maintainable without unnecessary boilerplate.
주요 기능
01Idempotency-Key patterns for safe POST retries and duplicate prevention
02Clear decision trees distinguishing Route Handlers, Server Actions, and webhooks
03Consistent JSON error handling conventions that prevent stack trace leaks
04Boundary input validation strategies using TypeScript and Zod schemas
050 GitHub stars
06Resource-oriented URL design and HTTP verb mapping for predictable API contracts
사용 사례
01Implementing safe retry mechanisms and idempotency keys for transactional mutations
02Standardizing API error response formats and HTTP status codes across teams
03Designing public or partner-facing REST JSON endpoints in Next.js App Router