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 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.
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:
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
{
"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:
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:
{
"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: Vollständige Tour durch das Dashboard
- Playground: Requests direkt im Dashboard testen, bevor du Code schreibst
- Smart Fetch (Auto): Detailübersicht zum Auto-Endpoint
- Den richtigen Endpoint wählen: Detaillierter Vergleich
- Häufige Probleme: Probleme schnell beheben