API

Conceptos de la API

Comprende la autenticación, las tareas asíncronas y el ciclo de vida de la API de conversión de documentos.

La API de Inkora se basa en REST, usa solicitudes y respuestas JSON y autentica cada solicitud mediante una clave de API Bearer.

URL base y autenticación

Todos los endpoints están disponibles bajo https://fusion-api.oomol.com/v1. Envía la clave de API mediante el encabezado Authorization.

text

Authorization: Bearer YOUR_API_KEY

No expongas esta clave en el código de frontend. Dirige el trabajo iniciado desde el navegador a través de tu propio backend.

Ciclo de vida de tareas asíncronas

La conversión de documentos es asíncrona. Un endpoint de envío devuelve sessionID, el identificador de tarea, y el endpoint de resultado correspondiente comunica uno de estos estados:

processing: el archivo está esperando o se está convirtiendo.
completed: el resultado contiene la URL de salida generada en data.downloadURL y los metadatos.
failed: el resultado contiene una razón de error que tu aplicación debe mostrar o registrar.

Tu integración debe dejar de consultar al llegar a un estado final, usar reintentos limitados y conservar el ID de tarea para soporte y recuperación.

Endpoints

La API actual admite conversión de PDF a Markdown y de PDF a EPUB. Consulta la Referencia de la API completa para rutas, parámetros, cargas de ejemplo y guías de SDK de Python y TypeScript.