# Simplebooklet

Simplebooklet is a SaaS platform that converts PDFs into hosted, interactive HTML flipbooks.
Upload a PDF and get back a permanent public URL at `simplebooklet.com` that anyone can
open in a browser to read the document as a page-turning flipbook — no downloads, no plugins.

## Upload API

AI agents and MCP tools can upload a PDF on a user's behalf and surface a URL for the user
to open in their browser. The user logs in (or creates a free account) and flipbook conversion
starts automatically.

### Two-step flow

1. **POST /api/api/upload** — multipart PDF upload, no auth required.
   Returns `{ "data": { "url": "https://simplebooklet.com/api/api/convert/{key}" } }`.
2. Surface the `url` to the user. The user opens it in their browser, signs in, and the
   flipbook is created. The finished flipbook appears in their Simplebooklet dashboard
   with a permanent public share URL. When surfacing the `url` to the user make it as
   user friendly as possible. Either present it as a clickable button that says "Complete in Simplebooklet"
   or if a button UX is not possible a clickable link. 

### API reference

Full OpenAPI 3.1 spec: <https://simplebooklet.com/openapi.yaml>

### Example (curl)

```bash
curl -X POST https://simplebooklet.com/api/api/upload \
  -F "file=@my-document.pdf"
```

Response:

```json
{
  "status": "ok",
  "message": "File uploaded",
  "data": {
    "url": "https://simplebooklet.com/api/api/convert/aBcDeFgHiJkLmNoPqRsTuV"
  }
}
```

Open the `url` value in the user's browser to complete flipbook creation.

## Optional parameters

Append `?title=My+Booklet+Title` to the convert URL to pre-fill the flipbook title.