API de desarrollador

API REST potente y sencilla: integra la conversión profesional de PDF a eBook en solo unas líneas de código.

URL base:https://fusion-api.oomol.com/v1

Autenticación

Todas las solicitudes requieren una API Key en el encabezado Authorization (formato: Bearer YOUR_API_KEY).

Authorization: Bearer YOUR_API_KEY
POST/pdf-transform-markdown/submit

Enviar tarea PDF a Markdown

Cargue la URL del archivo PDF y envíe la tarea para convertir al formato Markdown

Parámetros de la solicitud

  • pdfURL - URL de la nube de archivos PDF (cadena, obligatoria, obtenida de la API de carga de archivos)
  • model - Modelo de conversión (cadena, requerido, valor fijo: "gundam")
  • filename - Nombre del archivo de salida sin extensión (opcional), utilizado para un reconocimiento de archivos más sencillo
  • ignore_pdf_errors - Ignorar los errores de análisis PDF (opcional, predeterminado: verdadero)
  • ignore_ocr_errors - Ignorar errores de OCR (opcional, predeterminado: verdadero)

Ejemplo de solicitud

{
  "pdfURL": "cache://abc123.pdf",
  "model": "gundam",
  "filename": "my-document",
  "ignore_pdf_errors": true,
  "ignore_ocr_errors": true
}

Ejemplo de respuesta

{
  "success": true,
  "sessionID": "019aa097-f28d-7000-8d56-6a2987a7b144"
}
GET/pdf-transform-markdown/result/:taskId

Consulta PDF a Markdown Resultado

Consultar el estado de la tarea de conversión y el resultado por ID de tarea

Parámetros de URL

  • taskId - ID de tarea (ID de sesión devuelto por la API de envío)

Ejemplo de respuesta (procesamiento)

{
  "success": true,
  "state": "processing",
  "progress": 66
}

Ejemplo de respuesta (completado)

{
  "success": true,
  "state": "completed",
  "progress": 100,
  "data": {
    "downloadURL": "https://cdn.oomol.com/result.md"
  }
}

Ejemplo de respuesta (fallido)

{
  "success": false,
  "state": "failed",
  "progress": 0,
  "error": "Motivo del error de conversión"
}
POST/pdf-transform-epub/submit

Enviar tarea PDF a EPUB

Cargue la URL del archivo PDF y envíe la tarea para convertir al formato EPUB

Parámetros de la solicitud

  • pdfURL - URL de la nube de archivos PDF (cadena, obligatoria, obtenida de la API de carga de archivos)
  • model - Modelo de conversión (cadena, requerido, valor fijo: "gundam")
  • filename - Nombre del archivo de salida sin extensión (opcional), utilizado para un reconocimiento de archivos más sencillo
  • ignore_pdf_errors - Ignorar los errores de análisis PDF (opcional, predeterminado: verdadero)
  • ignore_ocr_errors - Ignorar errores de OCR (opcional, predeterminado: verdadero)

Ejemplo de solicitud

{
  "pdfURL": "cache://abc123.pdf",
  "model": "gundam",
  "filename": "my-document",
  "ignore_pdf_errors": true,
  "ignore_ocr_errors": true
}

Ejemplo de respuesta

{
  "success": true,
  "sessionID": "019aa097-f28d-7000-8d56-6a2987a7b144"
}
GET/pdf-transform-epub/result/:taskId

Consulta PDF a EPUB Resultado

Consultar el estado de la tarea de conversión y el resultado por ID de tarea

Parámetros de URL

  • taskId - ID de tarea (ID de sesión devuelto por la API de envío)

Ejemplo de respuesta (procesamiento)

{
  "success": true,
  "state": "processing",
  "progress": 66
}

Ejemplo de respuesta (completado)

{
  "success": true,
  "state": "completed",
  "progress": 100,
  "data": {
    "downloadURL": "https://cdn.oomol.com/result.epub"
  }
}

Ejemplo de respuesta (fallido)

{
  "success": false,
  "state": "failed",
  "progress": 0,
  "error": "Motivo del error de conversión"
}