Installation

Open Claude Code and run this command:

/plugin install rest-api-generator@claude-code-plugins-plus

Use --global to install for all projects, or --project for current project only.

What It Does

Generate production-ready RESTful APIs from schema definitions with proper routing, validation, error handling, and documentation.

Features

REST Principles - Resource-based URLs, proper HTTP methods
Validation - Request body, query params, path params
Authentication - JWT, OAuth, API key support
Documentation - OpenAPI 3.0 specification
Testing - Integration tests with Jest/Pytest
Pagination - Limit, offset, cursor-based
Filtering - Query parameter filtering
Sorting - Multi-field sorting
Rate Limiting - Prevent API abuse
CORS - Cross-origin support
Error Handling - Standardized error responses

Skills (1)

generating-rest-apis SKILL.md View full skill →

Generate complete REST API implementations from OpenAPI specifications or database schemas.

ReadWriteEditGrepGlobBash(api:rest-*)

Generating REST APIs

Overview

Generate complete, production-ready REST API implementations from OpenAPI specifications, database schemas, or resource definitions. Scaffold CRUD endpoints with proper HTTP method semantics, content negotiation, pagination, filtering, and HATEOAS link generation across Express, FastAPI, Spring Boot, and Gin frameworks.

Prerequisites

Node.js 18+ with Express/Fastify, or Python 3.10+ with FastAPI/Flask, or Java 17+ with Spring Boot, or Go 1.21+ with Gin/Echo
OpenAPI 3.0+ specification or database schema (SQL DDL, Prisma, Sequelize models)
HTTP testing tool: curl, httpie, or Postman
Database server (PostgreSQL, MySQL, MongoDB) accessible for ORM integration
Package manager configured (npm, pip, Maven, or go modules)

Instructions

Scan the project for existing OpenAPI specs, database models, or route definitions using Glob and Read to establish current API surface area.
Parse resource entities from the specification and generate model definitions with field types, validation constraints, and relationship mappings.
Create route files implementing all five standard REST operations per resource: GET /resources (list with pagination), GET /resources/:id, POST /resources, PUT /resources/:id, and DELETE /resources/:id.
Implement controller logic with input validation using JSON Schema or framework-native validators (Zod, Pydantic, Bean Validation).
Add query parameter support for filtering (?status=active), sorting (?sort=-created_at), field selection (?fields=id,name), and cursor-based or offset pagination.
Wire authentication middleware to protect mutation endpoints (POST, PUT, DELETE) while allowing read access per configuration.
Generate standardized error response envelopes with RFC 7807 Problem Details format for all 4xx/5xx responses.
Create integration tests covering happy paths, validation failures, 404s, and auth rejection for every endpoint.
Produce or update the OpenAPI 3.0 specification to match the generated implementation.

See ${CLAUDESKILLDIR}/references/implementation.md for the full step-by-step implementation guide.

Output

${CLAUDESKILLDIR}/src/routes/ - Express/Fastify route definitions with HTTP method handlers
${CLAUDESKILLDIR}/src/controllers/ - Business logic separated from routing
${CLAUDESKILLDIR}/src/models/ - ORM models with validation rules and relationships
${CLAUDESKILLDIR}/src/middleware/auth.js - JWT/API key authentication middleware
${CLAUDESKILLDIR}/src/middleware/validate.js - Request schema validation middleware

How It Works

Basic Usage


/generate-rest-api

Or use the shortcut:


/gra

What It Does

Asks about your API requirements (resources, operations, framework)
Generates complete REST API structure with routes, controllers, models
Adds validation schemas with Joi, Pydantic, or Zod
Implements authentication middleware (JWT, OAuth, API keys)
Creates OpenAPI/Swagger documentation
Generates integration tests for all endpoints
Follows REST best practices (proper HTTP methods, status codes, pagination)

Example Interaction


You: /generate-rest-api

Claude: I'll help you generate a RESTful API. Let me gather some details:

1. What resources/entities do you need? (e.g., users, posts, products)
2. What framework would you like? (Express, FastAPI, Django, Flask, NestJS)
3. What database? (PostgreSQL, MongoDB, MySQL)
4. Do you need authentication? (JWT, OAuth, API keys)

You: Users and posts, Express with PostgreSQL, JWT auth

Claude: [Generates complete API structure with routes, controllers, models, validation, tests, and OpenAPI docs]

rest-api-generator

Installation

What It Does

Features

Skills (1)

Generating REST APIs

Overview

Prerequisites

Instructions

Output

How It Works

Basic Usage

What It Does

Example Interaction

Ready to use rest-api-generator?

Related Plugins

rest-api-generator

Installation

What It Does

Features

Skills (1)

Generating REST APIs

Overview

Prerequisites

Instructions

Output

How It Works

Basic Usage

What It Does

Example Interaction

Ready to use rest-api-generator?

Related Plugins

api-authentication-builder

api-batch-processor

api-cache-manager

api-contract-generator

api-documentation-generator

api-error-handler