genebook.de API

El genebook.de API proporciona acceso programático a algunas funciones del servicio.

Conversión de páginas web a libros electrónicos

Este método del API convierte la página web especificada en un libro electrónico en formato EPUB, MOBI o FB2.
En caso de una solicitud exitosa, el API devuelve un campo result con un enlace desde el cual puede descargarse el archivo generado.

Parámetros (JSON Body)

Formato de solicitudes y respuestas

• Formato de datos: JSON
• Encabezados requeridos
Content-Type: application/json
• Las respuestas del API también se devuelven en formato JSON.

Ejemplo de solicitud (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"
        }'

Ejemplo de respuesta exitosa

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

Ejemplo de respuesta con error

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

Causas posibles de error

• Clave API inválida o ausente
• Formato no soportado
• URL incorrecta o inaccesible
• Error interno del conversor

Notas

• Puede haber límites de solicitudes por minuto (rate limit).
• El API está destinado a la automatización de tareas individuales. La conversión masiva o de uso industrial está prohibida sin autorización previa.
• El límite estándar actual para usuarios de la versión premium es de 200 conversiones por día.
• Las claves API se proporcionan a los usuarios de la versión premium a solicitud en el soporte técnico.

Integración rápida sin clave API

Si no necesita automatización y simplemente desea abrir el conversor con una dirección prellenada — pase la URL mediante el parámetro GET ?url=:

Es útil para bookmarklets y botones "Convertir" en sitios de terceros — sin clave API ni premium.