Reviews and guides REST API design using HTTP methods, status codes, and FastAPI patterns.
npx skills add https://github.com/Dazlarus/karl-code --skill rest-api-dazlarus
Please help me install this Agent Skill. Skill: rest-api Source: https://github.com/Dazlarus/karl-code/tree/main/.agents/skills/rest-api Command: npx skills add https://github.com/Dazlarus/karl-code --skill rest-api-dazlarus
High-intent search queries and answers about installing and using this skill.
Use HTTP methods semantically (GET for retrieval, POST for creation, PUT/PATCH for updates, DELETE for removal), return correct status codes, and validate requests and responses with Pydantic models. Add versioning, pagination, and consistent response envelopes for production APIs.
A POST endpoint that creates a resource should return 201 Created, not 200 OK. Return 409 Conflict when the resource already exists, and 204 No Content for successful DELETE operations.
Use offset-based pagination with page and page_size query parameters, returning a pagination metadata object with total counts. For infinite scroll or large datasets, use cursor-based pagination returning a next_cursor token.
Do not apply REST conventions to non-HTTP APIs such as GraphQL, gRPC, or WebSocket interfaces, or to internal interfaces that do not use HTTP. Those protocols have their own design conventions.
Mount separate FastAPI sub-applications under path prefixes like /v1 and /v2, or use header-based versioning with an X-API-Version header to route requests to different handler implementations.
nekorush14Implement FastAPI endpoints with Pydantic validation and dependency injection.
cosmixGenerate OpenAPI-based API documentation covering endpoints, schemas, authentication, and errors.
VladyslavBabiyAudit REST API contracts for HTTP semantics, versioning, and response consistency.
nekorush14Implement gRPC services and clients in Rails with Protocol Buffers.
