genebook.de – créer, convertir et partager des ebooks (fb2, epub, mobi)

L’API genebook.de offre un accès programmatique à certaines fonctions du service.

L’API est disponible uniquement pour les utilisateurs de la version premium.

Conversion de pages web en livres numériques

Cette méthode de l’API convertit la page web spécifiée en un livre numérique au format EPUB, MOBI ou FB2.
En cas de requête réussie, l’API renvoie un champ result contenant un lien permettant de télécharger le fichier généré.

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

Paramètres (corps JSON)

Paramètre	Type	Obligatoire	Description
url	string	yes	URL de la page web à convertir
format	string	yes	Format de sortie : epub, mobi, fb2
apiKey	string	yes	Votre clé API

Format des requêtes et des réponses

Format des données: JSON
En-têtes requis

Content-Type: application/json

Les réponses de l’API sont également renvoyées au format JSON.

Exemple de requête (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"
        }'

Exemple de réponse réussie

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

Exemple de réponse d’erreur

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

Causes possibles d’erreur

Clé API invalide ou manquante
Format non pris en charge
URL incorrecte ou inaccessible
Erreur interne du convertisseur

Notes

Des limitations de requêtes par minute (rate limit) peuvent s’appliquer.
L’API est destinée à l’automatisation de tâches individuelles. L’utilisation massive ou industrielle est interdite sans autorisation préalable.
La limite standard actuelle pour les utilisateurs de la version premium est de 200 conversions par jour.
Les clés API sont fournies aux utilisateurs de la version premium sur demande au support technique.

Intégration rapide sans clé API

Si vous n'avez pas besoin d'automatisation et souhaitez simplement ouvrir le convertisseur avec une adresse préremplie — transmettez l'URL via le paramètre GET ?url=:

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

C'est pratique pour les bookmarklets et les boutons « Convertir » sur des sites tiers — sans clé API ni premium.

genebook.de API