# html-share

Versioned, collaborative, AI-friendly HTML sharing platform.

## Service Purpose
Host self-contained HTML files (demos, slides, reports) with built-in versioning and multi-user collaboration.

## API Specification
Base URL: `${baseUrl}/api/v1`
Authentication: Bearer token (PAT)
Format: JSON `{ data: ..., error: ... }`

## Key Operations
- `POST /shares`: Create new share with `title`, `html`, `description?`.
- `POST /shares/:slug/versions`: Update content creating a new version.
- `GET /shares`: List available shares.
- `GET /shares/:slug`: Get metadata and current version.

## Reference Links
- Documentation: `${baseUrl}/docs`
- OpenAPI Spec: `${baseUrl}/openapi.yaml`
- Main Page: `${baseUrl}`