Einen Task erstellen

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 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 beschreibenden Namen (z. B. "production-scraper" oder "dev-testing"). Der Dialog API Key Created zeigt den Key im Klartext mit einem Kopier-Button und unter Test your first request einen ausführbaren curl-Befehl mit Copy command. Auf einem Smartphone oder Tablet führt dich stattdessen Try it in the Playground direkt dorthin.

Falls du ihn verpasst, klicke später in der Zeile des Keys auf das Augen-Symbol, um ihn erneut anzuzeigen. Ältere Keys, die vor Einführung der Anzeige-Funktion erstellt wurden, können nicht wiederhergestellt werden; generiere sie einmal neu, um umzusteigen. Vollständiger Ablauf: Managing API Keys.

Dein Key sieht so aus: pk_live_a1b2c3d4e5f6...

Schritt 3: Endpoint auswählen

FourA bietet vier Endpoints für verschiedene 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 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. Antwortzeit: typischerweise unter 2 Sekunden.

Browser (POST /api/browser/)

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

Proxy (POST /api/proxy/)

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

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: Response auslesen

{
  "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 Weiterleitungs-Hop. Jeder Eintrag enthält einen result mit der Statuszeile und allen Response-Headern, die das Ziel zurückgegeben hat.

Wichtige Felder:

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

Schritt 6: Einen Browser-Request testen

Wenn die Zielseite JavaScript zum Rendern von Inhalten nutzt, verwende 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

Nächste Schritte

• Dashboard-Übersicht: Vollständiger Dashboard-Überblick
• Playground: Teste Requests im Dashboard, bevor du Code schreibst
• Smart Fetch (Auto): Details zum Auto-Endpoint
• Den richtigen Endpoint wählen: Detaillierter Vergleich
• Häufige Probleme: Probleme schnell lösen