Lumière Public API

Authentication

All requests require an API key in the X-API-Key header. Keys are created by an administrator via the admin panel.

curl -H "X-API-Key: ak_..." \
  https://your-domain.com/api/public/ebooks

Rate limit

60 requests per 60 seconds per key. Exceeded requests return 429 Too Many Requests.

GET /api/public/ebooks

Returns the full catalog (without chapter content).

Response

{
  "data": [
    {
      "id": "uuid",
      "title": "Pinterest Marketing",
      "slug": "pinterest-marketing",
      "category": "Marketing",
      "description": "Turn Pinterest into…",
      "price": 14.99,
      "cover_url": "https://…",
      "is_featured": true,
      "tags": ["pinterest", "marketing"]
    }
  ],
  "count": 9
}

GET /api/public/ebooks/{'{slug}'}

Returns a single edition with the first chapter as preview.

Response

{
  "id": "uuid",
  "title": "Pinterest Marketing",
  "slug": "pinterest-marketing",
  "category": "Marketing",
  "description": "…",
  "price": 14.99,
  "tags": ["pinterest", "marketing"],
  "chapters": [
    { "id": "uuid", "title": "Foundations", "content": "Every meaningful…" }
  ],
  "is_preview": true
}