Lebenszyklus
Status
status
Angenommen und dauerhaft gespeichert. Wartet auf einen Worker.
status
Ein Worker hält eine Lease auf den Task und steuert die Engine.
status
Endzustand. Das Feld
response ist befüllt.status
Endzustand. Das Feld
error enthält den Grund.QUEUED zurück und wird erneut
versucht. Erst wenn alle Versuche aufgebraucht sind, landet er in FAILED. Übergänge PROCESSING → QUEUED sind also
normal und kein Anlass für einen Alarm.
Priorität
priority bleibt aus Kompatibilitätsgründen erhalten und wird in den Task-Metadaten zurückgegeben. Erlaubt sind 1
bis 10, Standard ist 1, und Werte außerhalb des Bereichs werden in den Bereich gezogen statt abgelehnt.
Aufbewahrung
Abgeschlossene Tasks sind 24 Stunden nach Abschluss über öffentliches Polling verfügbar. Danach liefertGET /v1/async/task/{id} 404 NOT_FOUND, dieselbe Antwort wie für eine id, die nie existiert hat. Der zugrunde liegende
Datensatz wird dauerhaft aufbewahrt; der Ablauf begrenzt öffentliches Polling und manuelles erneutes Senden von
Webhooks, nicht die Speicherung. Automatische Webhook-Wiederholungen laufen davon unabhängig weiter.
Wenn Sie auf Polling statt auf Webhooks setzen, holen Sie die Ergebnisse deutlich innerhalb dieses Zeitraums ab.
Webhook oder Polling
Bevorzugen Sie Webhooks. Polling ist der Weg zur Wiederherstellung.
Ein robuster Client macht beides: Er nutzt den Webhook als schnellen Weg und gleicht per Polling alles ab, wovon er
vor Ende des Aufbewahrungsfensters nichts gehört hat.