# api-documentation-generator

> Generate API docs using OpenAPI/Swagger, TSDoc, and interactive documentation

- Author: Ricardo Ruiz
- Repository: ruizrica/anthropic-cookbook
- Version: 20251118214353
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-08
- Source: https://github.com/ruizrica/anthropic-cookbook
- Web: https://mule.run/skillshub/@@ruizrica/anthropic-cookbook~api-documentation-generator:20251118214353

---

---
name: api-documentation-generator
description: Generate API docs using OpenAPI/Swagger, TSDoc, and interactive documentation
---

# API Documentation Generator

## OpenAPI 3.0
```yaml
openapi: 3.0.0
paths:
  /users/{id}:
    get:
      summary: Get user
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
components:
  schemas:
    User:
      type: object
      properties:
        id: { type: string }
        email: { type: string }
```

## TSDoc
```typescript
/**
 * Get user by ID
 * @param id - User ID
 * @returns User object
 * @throws {NotFoundError}
 */
async getUser(id: string): Promise<User>
```

## Tools
- Swagger UI
- ReDoc
- Postman
- API Blueprint