InkoraInkora

API per sviluppatori

API REST potente e semplice: integra la conversione professionale da PDF a eBook in poche righe di codice

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

Autenticazione

Tutte le richieste richiedono una chiave API nell'intestazione dell'autorizzazione (formato: Bearer YOUR_API_KEY)

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

Invia PDF all'attività Markdown

Carica l'URL del file PDF e invia l'attività per la conversione nel formato Markdown

Parametri della richiesta

  • pdfURL - URL cloud del file PDF (stringa, obbligatoria, ottenuta dall'API di upload file)
  • model - Modello di conversione (stringa, obbligatorio, valore fisso: "gundam")
  • filename - Nome del file di output senza estensione (opzionale), utilizzato per facilitare il riconoscimento del file
  • ignore_pdf_errors - Ignora gli errori di analisi PDF (opzionale, predefinito: true)
  • ignore_ocr_errors - Ignora errori OCR (facoltativo, impostazione predefinita: true)

Esempio di richiesta

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

Esempio di risposta

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

Interroga il risultato da PDF a Markdown

Interrogare lo stato e il risultato dell'attività di conversione in base all'ID attività

Parametri URL

  • taskId - ID attività (sessionID restituito dall'API di invio)

Esempio di risposta (elaborazione)

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

Esempio di risposta (Completato)

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

Esempio di risposta (non riuscita)

{
  "success": false,
  "state": "failed",
  "progress": 0,
  "error": "Motivo dell'errore di conversione"
}
POST/pdf-transform-epub/submit

Invia PDF all'attività EPUB

Carica l'URL del file PDF e invia l'attività per la conversione nel formato EPUB

Parametri della richiesta

  • pdfURL - URL cloud del file PDF (stringa, obbligatoria, ottenuta dall'API di upload file)
  • model - Modello di conversione (stringa, obbligatorio, valore fisso: "gundam")
  • filename - Nome del file di output senza estensione (opzionale), utilizzato per facilitare il riconoscimento del file
  • ignore_pdf_errors - Ignora gli errori di analisi PDF (opzionale, predefinito: true)
  • ignore_ocr_errors - Ignora errori OCR (facoltativo, impostazione predefinita: true)

Esempio di richiesta

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

Esempio di risposta

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

Interroga il risultato da PDF a EPUB

Interrogare lo stato e il risultato dell'attività di conversione in base all'ID attività

Parametri URL

  • taskId - ID attività (sessionID restituito dall'API di invio)

Esempio di risposta (elaborazione)

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

Esempio di risposta (Completato)

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

Esempio di risposta (non riuscita)

{
  "success": false,
  "state": "failed",
  "progress": 0,
  "error": "Motivo dell'errore di conversione"
}