eBooks API

The eBooks API allows external systems to fetch public ebooks content from your Makinari site.

Endpoints

Get Public eBooks GET

Retrieves all published ebooks for a specific site. The site is identified either by the url query parameter or by automatically detecting the request’s Origin or Referer headers.

GET /api/public/ebooks?limit=100

Authentication Requirements:

• From a registered domain (Browser): No API key required. The domain must be correctly configured in your Makinari site settings.
• From a server/machine (No Origin): Requires an API Key sent as a Bearer token in the Authorization header.

Parameters:

• url (optional): The URL or domain of your site (e.g., example.com or https://example.com). If not provided, the API will try to infer it from the request headers.
• search (optional): Query string to search within title, description, or text content.
• limit (optional): Maximum number of posts to return (default: 100).

Response:

{
  "success": true,
  "site": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "My Blog Site",
    "url": "https://example.com"
  },
  "data": [
    {
      "id": "987fcdeb-51a2-43d7-9012-3456789abcdef",
      "title": "Welcome to our new blog",
      "description": "An introduction to our content",
      "type": "ebook",
      "status": "published",
      "text": "Full content of the blog post...",
      "tags": ["announcement", "welcome"],
      "published_at": "2024-05-20T10:00:00Z",
      "created_at": "2024-05-18T14:30:00Z",
      "assets": [
        {
          "id": "3deb1ee4-264f-4891-b697-5bfa6586c4e9",
          "name": "hero-image",
          "file_path": "https://storage.url/assets/image.jpg",
          "file_type": "image/jpeg",
          "position": 0,
          "is_primary": true
        }
      ]
    }
  ],
  "total": 1
}