Diese Anleitung verwendet cURL und den Endpunkt PDF-zu-Markdown. Für die EPUB-Konvertierung gilt dasselbe Muster aus Übermitteln und Abfragen.
1. API-Schlüssel erstellen
Erstellen Sie einen API-Schlüssel in der OOMOL Console. Bewahren Sie ihn auf Ihrem Server oder in einem Secret Manager auf; binden Sie ihn niemals in ein Browser-Bundle oder eine öffentliche Client-Anwendung ein.
2. Konvertierungsaufgabe übermitteln
Ersetzen Sie den Beispielschlüssel und die PDF-URL und senden Sie dann eine Anfrage an den Submit-Endpunkt.
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"}'
Die Antwort enthält sessionID, also die Task-ID. Speichern Sie diesen Wert zusammen mit Ihrem eigenen Job-Datensatz und verwenden Sie ihn unten anstelle von TASK_ID, damit Wiederholungen und Downloads nachvollziehbar bleiben.
3. Ergebnis abfragen
Fragen Sie den Ergebnis-Endpunkt ab, bis der Status completed oder failed lautet oder Ihre maximale Anzahl von Versuchen beziehungsweise Ihre Frist erreicht ist. Behandeln Sie jede Nicht-2xx-Antwort als Fehler und beenden Sie die Abfrage bei einem unbekannten state. Starten Sie mit einer kurzen Wartezeit und verlängern Sie das Intervall bei längeren Dokumenten.
curl --request GET "https://fusion-api.oomol.com/v1/pdf-transform-markdown/result/TASK_ID" \--header "Authorization: Bearer YOUR_API_KEY"
Lesen Sie den Task-Status aus state. Bei completed laden Sie die erzeugte Datei über data.downloadURL herunter; bei failed protokollieren und behandeln Sie den zurückgegebenen Fehlergrund.
Nächste Schritte
- Lesen Sie die API-Konzepte für Authentifizierung, Task-Status und Wiederholungen.
- Nutzen Sie die API-Referenz, wenn Sie Details zu Request- und Response-Feldern benötigen.