​

Async-Jobs und Polling

Die meisten Schreiboperationen sind asynchron.

​

Was sofort zurückgegeben wird

Diese Endpunkte nehmen Arbeit an und geben IDs zurück, die Sie per Polling abfragen können:

• POST /projects
• POST /projects/{projectId}/tasks/stem-separation
• POST /projects/{projectId}/tasks/lyrics-sync
• POST /projects/{projectId}/exports

​

Was per Polling abgefragt werden sollte

• Fragen Sie GET /tasks/{taskId} per Polling nach Ausführungsstatus und aufgefüllter Task-Ausgabe ab.
• Lesen Sie GET /projects/{projectId} für den langlebigen Projektzustand.
• Lesen Sie GET /exports/{exportId} für aktuelle Export-Download-URLs.

​

Praktisches Polling-Modell

1. Starten Sie eine Mutation und speichern Sie die zurückgegebenen IDs.
2. Fragen Sie GET /tasks/{taskId} per Polling ab, bis die Aufgabe einen terminalen Status erreicht.
3. Lesen Sie die dauerhafte Ressource per ID erneut, statt veraltetem gecachten Zustand zu vertrauen.
4. Für Downloads rufen Sie GET /exports/{exportId} ab, wenn Sie bereit sind, die URL zu verwenden.

​

Warum das wichtig ist

• Der Task-Status ist die Ausführungszeitleiste.
• Der Projektzustand ist die dauerhafte „Source of Truth“.
• Export-Download-URLs sollten als aktualisierbar statt dauerhaft behandelt werden.