API

Concepts de l’API

Comprenez l’authentification, les tâches asynchrones et le cycle de vie de l’API de conversion de documents.

L’API Inkora est basée sur REST, utilise des requêtes et réponses JSON et authentifie chaque requête avec une clé API Bearer.

URL de base et authentification

Tous les endpoints sont disponibles sous https://fusion-api.oomol.com/v1. Envoyez la clé API dans l’en-tête de requête Authorization.

text

Authorization: Bearer YOUR_API_KEY

N’exposez pas cette clé dans le code frontend. Faites passer les tâches lancées depuis le navigateur par votre propre backend.

Cycle de vie d’une tâche asynchrone

La conversion de documents est asynchrone. Un endpoint d’envoi renvoie sessionID, l’identifiant de tâche, et l’endpoint de résultat correspondant indique l’un de ces états :

processing : le fichier attend ou est en cours de conversion.
completed : le résultat contient l’URL de sortie générée dans data.downloadURL et des métadonnées.
failed : le résultat contient un motif d’échec que votre application doit afficher ou journaliser.

Votre intégration doit arrêter l’interrogation à un état final, utiliser des tentatives limitées et conserver l’identifiant de tâche pour le support et la récupération.

Endpoints

L’API actuelle prend en charge la conversion de PDF vers Markdown et de PDF vers EPUB. Consultez la Référence API complète pour les chemins, paramètres, payloads d’exemple et guides des SDK Python et TypeScript.