Behandeln Sie ein Konvertierungsergebnis als zustandsbehafteten Job und nicht als synchronen Dateidownload. So bleibt Ihr Produkt zuverlässig, wenn Quelldateien groß, nicht verfügbar oder fehlerhaft sind.
Sicher wiederholen
Wiederholen Sie nur Requests, die gefahrlos erneut ausgeführt werden können. Ergebnisanfragen können mit exponentiellem Backoff wiederholt werden. Speichern Sie bei Submit-Requests die Task-ID einer erfolgreichen Antwort, bevor Sie eine weitere Übermittlung versuchen.
Endgültige Fehler behandeln
Wenn ein Task den Status failed hat, protokollieren Sie seine Task-ID und den zurückgegebenen Grund zusammen mit Ihrer internen Job-ID. Zeigen Sie Nutzern einen konkreten nächsten Schritt, etwa die Prüfung der Quell-URL oder das Hochladen einer lesbaren PDF, statt einen unbearbeiteten API-Fehler auszugeben.
Praktische Zeitlimits setzen
Legen Sie eine Abfragefrist fest, die zu Ihrem Produkterlebnis passt. Beenden Sie die Abfrage nach dieser Frist, bewahren Sie die Task-ID auf und lassen Sie einen Hintergrundprozess oder eine manuelle Aktualisierung den endgültigen Status später prüfen.
Exakte Response-Felder und Fehlerbeispiele finden Sie in der API-Referenz.