> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Task-API und Wiederherstellung

Stellen Sie eine unklare Übermittlung wieder her, ohne eine neue Aufgabe anzulegen.

## Bevor Sie beginnen

Öffnen Sie Ihr heruntergeladenes Supastack-Projekt in Visual Studio Code über Datei → Ordner öffnen und wählen Sie dann Terminal → Neues Terminal. Das Repository-Stammverzeichnis ist der Ordner, der package.json, Apps und Pakete enthält. Führen Sie dort den Befehl unten aus und lassen Sie das Terminal geöffnet. Wenn ein Befehl nicht erkannt wird, lesen Sie die Installationsanleitung für das Tool durch, bevor Sie fortfahren.

Lesen Sie zuerst das Plattform-Tutorial. Ein Server ist der App-Prozess, der Browser- oder Telefonanfragen beantwortet. Web liest apps/web/.env.local, Expo liest apps/mobile/.env.local und Datenbankmigrationsbefehle lesen root .env. Die Demonstration ohne Datenbank /Dashboard ist getrennt von echten /Auth-Konten, die migriert werden müssen Postgres. Für eine reine Telefon- oder Desktop-Kaufabwicklung ist ein separat ausgeführtes Web-Backend erforderlich.

[Installieren Sie die Tools und erhalten Sie den Code](https://supastack.dev/de/docs/web/before-you-start.md)

[Befehle, Dateien und Konfiguration lernen](https://supastack.dev/de/docs/web/terminal-basics.md)

[Schließen Sie das Web-Tutorial zur ersten Ausführung ab](https://supastack.dev/de/docs/web/ship-in-5-minutes.md)

```
corepack pnpm --filter @supastack/web dev
```


## Einrichtung und Konfiguration

POST /api/ai/tasks erfordert einen authentifizierten Workspace und eine aktive Berechtigung. Eine Anfrage mit Schlüssel reserviert vor dem Dispatch eine unveränderliche Aufgabe. Idempotency-Key akzeptiert 16 bis 128 ASCII-Buchstaben, Ziffern, Unterstriche oder Bindestriche.

```
POST /api/ai/tasks
Idempotency-Key: a-stable-client-submission-key

Recovery body: { "resume": true }
Status: GET /api/ai/tasks/{taskId}
```


## Implementierungsablauf

Speichern Sie den Wiederherstellungsschlüssel vor dem Absenden. Bei unklarem Dispatch verwenden Sie denselben Schlüssel und den Resume-Anfragekörper erneut; der Server lädt die ursprünglichen Eingaben und versucht dieselbe aufgabenbezogene Trigger-Identität erneut. Geänderte Eingaben unter demselben Schlüssel geben 409 idempotencyConflict zurück.

HTTP 202 nach einem unklaren Enqueue bedeutet, dass der Dispatch-Status offen ist. Es beweist nicht, dass Trigger die Arbeit angenommen hat. Bereits laufende oder abgeschlossene Aufgaben geben ihren gespeicherten Status zurück, ohne erneut eingereiht zu werden. Für die Wiederherstellung sind weiterhin Authentifizierung, Eigentümerschaft und Berechtigung erforderlich.


## Überprüfung und Fehlerbehebung

Simulieren Sie eine verlorene Antwort, einen Konflikt durch geänderte Eingaben, eine Anfrage aus einem fremden Workspace und die Wiederherstellung nach einem Refresh. Es gibt weder einen automatischen Outbox-Dispatcher noch eine Ende-zu-Ende-Garantie für genau eine Ausführung. Setzen Sie eine laufende Aufgabe nicht auf queued zurück, ohne zuvor ihre Nebenwirkungen zu untersuchen.


## Weiter

[Trigger.dev-Jobs](https://supastack.dev/de/docs/modules/jobs.md)