Ir al contenido principal
Inkora
Inkora
Star
Descarga para escritorio

Primeros pasos

Inicio rápido

Envía una tarea de conversión de PDF y recupera el resultado en pocos minutos.

Esta guía utiliza cURL y el endpoint de PDF a Markdown. El mismo patrón de envío y consulta se aplica a la conversión a EPUB.

1. Crea una clave de API

Crea una clave de API en OOMOL Console. Guárdala en tu servidor o en un gestor de secretos; no la incluyas nunca en un bundle del navegador ni en una aplicación cliente pública.

2. Envía una tarea de conversión

Sustituye la clave y la URL de PDF de ejemplo y envía una solicitud al endpoint de envío.

bash
curl --request POST "https://fusion-api.oomol.com/v1/pdf-transform-markdown/submit" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "pdfURL": "https://example.com/guide.pdf",
    "model": "gundam"
  }'

La respuesta contiene sessionID, que es el ID de tarea. Guárdalo junto con tu propio registro de trabajo y úsalo en lugar de TASK_ID a continuación para que los reintentos y las descargas sean rastreables.

3. Consulta el resultado

Solicita el endpoint de resultado hasta que el estado sea completed o failed, o hasta alcanzar el número máximo de intentos o la fecha límite. Trata cualquier respuesta que no sea 2xx como un error y deja de consultar si state es desconocido. Empieza con una espera breve y aumenta el intervalo entre intentos para documentos más largos.

bash
curl --request GET "https://fusion-api.oomol.com/v1/pdf-transform-markdown/result/TASK_ID" \
  --header "Authorization: Bearer YOUR_API_KEY"

Lee el estado de la tarea desde state. Cuando sea completed, descarga el archivo generado desde data.downloadURL; cuando sea failed, registra y gestiona la razón de error devuelta.

Siguientes pasos