Ce guide utilise cURL et l’endpoint PDF-vers-Markdown. Le même modèle d’envoi puis d’interrogation s’applique à la conversion EPUB.
1. Créer une clé API
Créez une clé API dans OOMOL Console. Conservez-la sur votre serveur ou dans un gestionnaire de secrets ; ne l’incluez jamais dans un bundle navigateur ou une application cliente publique.
2. Envoyer une tâche de conversion
Remplacez la clé et l’URL de PDF d’exemple, puis envoyez une requête à l’endpoint d’envoi.
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 réponse contient sessionID, qui correspond à l’identifiant de tâche. Enregistrez cette valeur avec votre propre enregistrement de travail et utilisez-la à la place de TASK_ID ci-dessous afin que les nouvelles tentatives et les téléchargements restent traçables.
3. Interroger le résultat
Interrogez l’endpoint de résultat jusqu’à ce que le statut soit completed ou failed, ou jusqu’à atteindre votre nombre maximal de tentatives ou votre délai maximal. Traitez toute réponse non 2xx comme une erreur et arrêtez l’interrogation si state est inconnu. Commencez avec un court délai, puis augmentez l’intervalle entre les tentatives pour les documents plus longs.
curl --request GET "https://fusion-api.oomol.com/v1/pdf-transform-markdown/result/TASK_ID" \--header "Authorization: Bearer YOUR_API_KEY"
Lisez l’état de la tâche dans state. Lorsqu’il vaut completed, téléchargez le fichier généré depuis data.downloadURL ; lorsqu’il vaut failed, journalisez et traitez le motif d’échec retourné.
Étapes suivantes
- Consultez les concepts de l’API pour l’authentification, les états de tâche et les tentatives.
- Utilisez la Référence API pour les détails des champs de requête et de réponse.