Docs › Dashboard › Einen Task erstellen

Einen Task erstellen

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

Schritt 1: Das Dashboard öffnen

Navigiere zum Dashboard und melde dich mit deinem FourA-Konto an.

Schritt 2: Einen API-Key erstellen

Gehe zur Seite API Keys und klicke auf Create Key.

Gib dem Key einen beschreibenden Namen (z. B. "production-scraper" oder "dev-testing"). Der Bestätigungsdialog zeigt den Key im Klartext mit einem Kopier-Button.

Falls du ihn verpasst, klicke später auf das Augen-Symbol in der Zeile des Keys, um ihn wieder anzuzeigen. Alte Keys, die vor dieser Funktion erstellt wurden, können nicht wiederhergestellt werden; generiere sie einmal neu, um zu wechseln. Vollständiger Ablauf: Managing API Keys.

Dein Key sieht so aus: pk_live_a1b2c3d4e5f6...

Schritt 3: Einen Endpoint wählen

FourA bietet vier Endpoints für unterschiedliche Szenarien:

Auto (POST /api/auto/)

Der intelligente Standard. Übergib eine URL sowie eine validate-Regel und FourA wählt den günstigsten funktionierenden Pfad: direkter Request, rotierender Proxy oder vollständiger Browser. Ideal, wenn du eine neue Seite anvisierst und noch nicht weißt, was sie benötigt.

Single (POST /api/single/)

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

Browser (POST /api/browser/)

Führt eine Chrome-Browser-Instanz aus, um JavaScript zu rendern. Am besten für SPAs, Lazy-Loading-Inhalte und Seiten, die JS-Ausführung erfordern. Response-Zeit: 2 bis 10 Sekunden.

Proxy (POST /api/proxy/)

Leitet den Request durch rotierende Proxys mit automatischem Retry. Am besten für Seiten mit Bot-Erkennung oder geografisch eingeschränkten Inhalten.

Schritt 4: Deinen ersten Request senden

Öffne ein Terminal und führe Folgendes aus:

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: Die Response lesen

{
  "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 ein result mit der Statuszeile sowie jedem Response-Header, den das Ziel zurückgegeben hat.

Wichtige Felder:

  • status: HTTP-Statuscode der Zielseite
  • data: der Response-Body (HTML, JSON oder roher Text)
  • total_time: Request-Dauer in Sekunden

Schritt 6: Einen Browser-Request testen

Wenn die Zielseite JavaScript verwendet, um Inhalte zu rendern, nutze stattdessen den Browser-Endpoint:

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 anstelle von data:

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

Häufige Probleme

Problem Lösung
Unsicher, welche Engine genutzt werden soll Starte mit dem Auto-Endpoint. Er wählt den richtigen Pfad und merkt sich, was funktioniert hat.
Leerer Inhalt Wechsle vom Single- zum Browser-Endpoint: Die Seite benötigt wahrscheinlich JS-Rendering
Captcha in der Response Wechsle zum Proxy-Endpoint für automatische IP-Rotation
Timeout Erhöhe timeout_ms oder überprüfe, ob die URL korrekt ist
Key verloren Klicke auf das Augen-Symbol in der Zeile des Keys unter API Keys, um ihn anzuzeigen, oder generiere ihn neu, falls es ein alter Key ist

Nächste Schritte

Aktualisiert: 8. Juli 2026
← Dashboard-Übersicht API-Keys verwalten →