API de développeur

API RESTful puissante et simple : implémentez une conversion professionnelle de PDF en eBook en quelques lignes de code seulement

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

Authentification

Toutes les requêtes nécessitent une clé API dans l'entête Authorization (format : Bearer YOUR_API_KEY)

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

Soumettre le PDF à la tâche Markdown

Téléchargez l'URL du fichier PDF et soumettez la tâche pour la convertir au format Markdown

Paramètres de la requête

  • pdfURL - URL du cloud du fichier PDF (chaîne, obligatoire, obtenue à partir de l'API de téléchargement de fichiers)
  • model - Modèle de conversion (chaîne, obligatoire, valeur fixe : "gundam")
  • filename - Nom du fichier de sortie sans extension (facultatif), utilisé pour une reconnaissance plus facile du fichier
  • ignore_pdf_errors - Ignorer les erreurs d'analyse PDF (facultatif, par défaut : vrai)
  • ignore_ocr_errors - Ignorer les erreurs OCR (facultatif, par défaut : vrai)

Exemple de requête

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

Exemple de réponse

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

Requête PDF vers le résultat Markdown

Statut de la tâche de conversion de requête et résultat par ID de tâche

Paramètres d'URL

  • taskId - ID de tâche (ID de session renvoyé par l'API de soumission)

Exemple de réponse (traitement)

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

Exemple de réponse (terminé)

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

Exemple de réponse (échec)

{
  "success": false,
  "state": "failed",
  "progress": 0,
  "error": "Raison de l'échec de la conversion"
}
POST/pdf-transform-epub/submit

Soumettre un PDF à une tâche EPUB

Téléchargez l'URL du fichier PDF et soumettez la tâche pour la convertir au format EPUB

Paramètres de la requête

  • pdfURL - URL du cloud du fichier PDF (chaîne, obligatoire, obtenue à partir de l'API de téléchargement de fichiers)
  • model - Modèle de conversion (chaîne, obligatoire, valeur fixe : "gundam")
  • filename - Nom du fichier de sortie sans extension (facultatif), utilisé pour une reconnaissance plus facile du fichier
  • ignore_pdf_errors - Ignorer les erreurs d'analyse PDF (facultatif, par défaut : vrai)
  • ignore_ocr_errors - Ignorer les erreurs OCR (facultatif, par défaut : vrai)

Exemple de requête

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

Exemple de réponse

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

Résultat de la requête PDF vers EPUB

Statut de la tâche de conversion de requête et résultat par ID de tâche

Paramètres d'URL

  • taskId - ID de tâche (ID de session renvoyé par l'API de soumission)

Exemple de réponse (traitement)

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

Exemple de réponse (terminé)

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

Exemple de réponse (échec)

{
  "success": false,
  "state": "failed",
  "progress": 0,
  "error": "Raison de l'échec de la conversion"
}