# Einen Task erstellen

> URL: https://foura.ai/de/docs/dashboard/creating-a-task
> Updated: 2026-10-28
> Index: https://foura.ai/llms.txt

Diese Anleitung führt dich durch die Erstellung eines API-Keys und das Senden deines ersten Requests über das FourA Dashboard.

## Schritt 1: Dashboard öffnen

Gehe zum [Dashboard](https://foura.ai/dashboard) und melde dich mit deinem FourA-Konto an.

## Schritt 2: API-Key erstellen

Gehe zur Seite **API Keys** und klicke auf **Create API key**. Sobald du einen Key hast, heißt der Button über der Liste **Create Key**.

Gib dem Key einen aussagekräftigen Namen (z. B. "production-scraper" oder "dev-testing"). Der Dialog **API Key Created** zeigt den Key im Klartext mit einem Kopier-Button sowie unter **Test your first request** einen ausführbaren cURL-Befehl mit **Copy command**. Auf einem Smartphone oder Tablet führt dich **Try it in the Playground** stattdessen dorthin.

Falls du ihn verpasst, klicke später in der Zeile des Keys auf das Augen-Symbol, um ihn wieder anzuzeigen. Ältere Keys, die vor der Reveal-Funktion erstellt wurden, können nicht wiederhergestellt werden; generiere sie einmal neu, um zu wechseln. Vollständiger Ablauf: [Managing API Keys](https://foura.ai/docs/dashboard/api-keys).

Dein Key sieht so aus: `pk_live_a1b2c3d4e5f6...`

## Schritt 3: Endpoint wählen

FourA bietet vier Endpoints für verschiedene Szenarien:

### Auto (`POST /api/auto/`)

Der smarte Standard. Übergib eine URL, idealerweise mit einer `validate`-Regel, und FourA durchläuft eine Eskalationsstufe vom rotierenden Proxy bis zum vollständigen Browser über einen Proxy und stoppt bei der ersten erfolgreichen Response. Setze `forceProxy: false`, um zuerst einen direkten Request zu versuchen. Ideal, wenn du eine neue Seite ansteuerst und noch nicht weißt, was sie erfordert.

### Single (`POST /api/single/`)

Sendet einen schnellen HTTP-Request. Ideal für statische HTML-Seiten und API-Endpoints. Response-Zeit: typischerweise unter 2 Sekunden.

### Browser (`POST /api/browser/`)

Startet eine Chrome-Browser-Instanz, um JavaScript zu rendern. Ideal für SPAs, Lazy-Loaded-Inhalte und Seiten, die JS-Ausführung erfordern. Response-Zeit: 2 bis 10 Sekunden.

### Proxy (`POST /api/proxy/`)

Leitet den Request über rotierende Proxys mit automatischem Retry weiter. Ideal für Seiten, die den Client prüfen oder je nach Land unterschiedliche Antworten liefern.

## Schritt 4: Ersten Request senden

Öffne ein Terminal und führe Folgendes aus:

```bash
curl -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "GET", "url": "https://example.com"}'
```

## Schritt 5: Response lesen

```json
{
  "status": 200,
  "headers": [
    {
      "result": { "version": "HTTP/2", "code": 200, "reason": "" },
      "content-type": "text/html; charset=UTF-8",
      "content-length": "1256"
    }
  ],
  "data": "<html>...</html>",
  "total_time": 0.45
}
```

Das Feld `headers` ist ein Array von Objekten, eines pro Redirect-Hop. Jeder Eintrag enthält `result` mit der Statuszeile sowie allen Response-Headern, die das Ziel zurückgegeben hat.

Wichtige Felder:
- **status**: HTTP-Statuscode der Zielseite
- **data**: der Response-Body (HTML, JSON oder Plain Text)
- **total_time**: Request-Dauer in Sekunden

## Schritt 6: Teste einen Browser-Request

Wenn die Zielseite JavaScript zum Rendern von Inhalten nutzt, verwende stattdessen den Browser-Endpoint:

```bash
curl -X POST https://eu.api.foura.ai/api/browser/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/products", "timeout_ms": 15000}'
```

Die Browser-Response verwendet `body` statt `data`:

```json
{
  "status": 200,
  "headers": {"content-type": "text/html"},
  "body": "<html>...</html>"
}
```

## Häufige Probleme

| Problem | Lösung |
|---------|----------|
| Nicht sicher, welche Engine zu nutzen ist | Starte mit dem Auto-Endpoint. Er wählt den passenden Pfad und merkt sich funktionierende Ansätze. |
| Leerer Inhalt | Wechsle vom Single- zum Browser-Endpoint: Die Seite benötigt wahrscheinlich JS-Rendering |
| Verifizierungsseite in der Response | Wechsle zum Proxy-Endpoint für automatische IP-Rotation |
| Timeout | Erhöhe `timeout_ms` oder prüfe, ob die URL korrekt ist |
| Key verloren | Klicke in der Zeile des Keys unter **API Keys** auf das Augensymbol, um ihn anzuzeigen, oder erstelle ihn neu, falls es ein Legacy-Key ist |

## Nächste Schritte

- [Dashboard-Übersicht](https://foura.ai/docs/dashboard/overview): Vollständige Tour durch das Dashboard
- [Playground](https://foura.ai/docs/dashboard/playground): Requests direkt im Dashboard testen, bevor du Code schreibst
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): Detailübersicht zum Auto-Endpoint
- [Den richtigen Endpoint wählen](https://foura.ai/docs/guides/choosing-task-type): Detaillierter Vergleich
- [Häufige Probleme](https://foura.ai/docs/troubleshooting/common-issues): Probleme schnell beheben
