# Swagger UI Server

Interactive API documentation server for the eMoney Token Factory API.

## Quick Start

```bash
# Install dependencies
pnpm install

# Start server
pnpm start

# Or in development mode
pnpm run dev
```

The Swagger UI will be available at:
- **Documentation**: http://localhost:8080/api-docs
- **OpenAPI JSON**: http://localhost:8080/openapi.json
- **OpenAPI YAML**: http://localhost:8080/openapi.yaml

## Features

- ✅ Interactive API documentation
- ✅ Try-it-out functionality
- ✅ Request/response examples
- ✅ Authentication testing (OAuth2, mTLS, API Key)
- ✅ Schema exploration
- ✅ Export OpenAPI spec (JSON/YAML)

## Configuration

Set environment variables:

```bash
export SWAGGER_PORT=8080  # Default: 8080
```

## Usage

1. Navigate to http://localhost:8080/api-docs
2. Click "Authorize" to set up authentication
3. Explore endpoints by expanding sections
4. Use "Try it out" to test API calls
5. View request/response schemas

## Integration

This server can be:
- Deployed standalone for documentation
- Integrated into main API server
- Used in CI/CD for API validation
- Embedded in developer portals