genebook.de - E-Books erstellen, teilen und konvertieren (fb2, epub, mobi)

Die genebook.de API bietet programmgesteuerten Zugriff auf bestimmte Funktionen des Dienstes.

Die API ist nur für Nutzer der Premium Version verfügbar.

Konvertierung von Webseiten in E-Books

Diese API-Methode konvertiert eine angegebene Webseite in ein elektronisches Buchformat (EPUB, MOBI oder FB2).
Bei einer erfolgreichen Anfrage gibt die API einen result-Link zurück, über den die erzeugte E-Book-Datei heruntergeladen werden kann.

POST https://genebook.de/api/v3/converter/

Parameter (JSON-Body)

Parameter	Typ	Erforderlich	Beschreibung
url	string	yes	URL der zu konvertierenden Webseite
format	string	yes	Ausgabeformat: epub, mobi, fb2
apiKey	string	yes	Ihr API-Schlüssel

Format von Anfragen und Antworten

Datenformat: JSON
Anfrage-Header

Content-Type: application/json

Die API-Antworten werden ebenfalls im JSON-Format zurückgegeben.

Beispielanfrage (cURL)

curl -X POST "https://genebook.de/api/v3/converter/" \
        -H "Content-Type: application/json" \
        -d '{
        "url": "https://example.com/article",
        "format": "epub",
        "apiKey": "YOUR_API_KEY"
        }'

Beispiel einer erfolgreichen Antwort

{
    "status": "success",
    "result": "https://genebook.de/downloads/q1w2e3r4t5y",
    "name": "article123.epub"
}

Beispiel einer Fehlermeldung

{
    "status": "error",
    "message": "Invalid or missing API key"
}

Mögliche Fehlerursachen

Ungültiger oder fehlender API-Schlüssel
Nicht unterstütztes Format
Nicht erreichbare oder ungültige URL
Interner Fehler des Konverters

Hinweise

Es können Beschränkungen bezüglich der Anzahl von Anfragen pro Minute gelten (Rate-Limit).
Die API ist für die Automatisierung individueller Aufgaben vorgesehen. Eine massenhafte oder industrielle Nutzung ist ohne vorherige Genehmigung untersagt.
Die aktuelle Standardbegrenzung für Nutzer der Premium Version beträgt 200 Konvertierungen pro Tag.
API-Schlüssel werden Nutzern der Premium Version auf Anfrage beim Support bereitgestellt.

Schnelle Integration ohne API-Schlüssel

Wenn Sie keine Automatisierung benötigen, sondern den Converter einfach mit einer vorausgefüllten Adresse öffnen möchten — übergeben Sie die URL über den GET-Parameter ?url=:

        https://genebook.de/de/converter/web-to-ebook/?url=https%3A%2F%2Fexample.com%2Farticle
    

Das ist praktisch für Bookmarklets und „Konvertieren"-Buttons auf Drittanbieter-Websites — ohne API-Schlüssel und ohne Premium.