Dokumentacja › Dashboard › Pierwsze zapytanie

Pierwsze zapytanie

Ten poradnik przeprowadzi Cię przez proces tworzenia klucza API i wysyłania pierwszego zapytania za pomocą Dashboardu FourA.

Step 1: Open the Dashboard

Przejdź do Dashboardu i zaloguj się na swoje konto FourA.

Step 2: Create an API Key

Przejdź do strony API Keys i kliknij Create Key.

Nadaj kluczowi opisową nazwę (np. "production-scraper" lub "dev-testing"). Pełny klucz jest widoczny tylko raz, więc skopiuj go od razu.

Twój klucz wygląda tak: pk_live_a1b2c3d4e5f6...

Step 3: Choose an Endpoint

FourA oferuje trzy endpointy dla różnych scenariuszy:

Single (POST /api/single/)

Wysyła szybkie zapytanie HTTP. Najlepsze dla statycznych stron HTML i endpointów API. Czas odpowiedzi: zazwyczaj poniżej 2 sekund.

Browser (POST /api/browser/)

Uruchamia instancję przeglądarki Chrome w celu wyrenderowania JavaScriptu. Najlepsze dla aplikacji SPA, leniwie ładowanych treści oraz stron wymagających wykonania JS. Czas odpowiedzi: od 2 do 10 sekund.

Proxy (POST /api/proxy/)

Kieruje zapytanie przez rotacyjne proxy z automatycznym ponawianiem. Najlepsze dla stron z detekcją botów lub treściami z ograniczeniami geograficznymi.

Step 4: Send Your First Request

Otwórz terminal i uruchom:

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"}'

Step 5: Read the Response

{
  "status": 200,
  "headers": [["content-type", "text/html"]],
  "data": "<html>...</html>",
  "total_time": 0.45
}

Kluczowe pola:

  • status: kod statusu HTTP z docelowej witryny
  • data: treść odpowiedzi (HTML, JSON lub zwykły tekst)
  • total_time: czas trwania zapytania w sekundach

Step 6: Try a Browser Request

Jeśli docelowa strona używa JavaScriptu do renderowania treści, użyj zamiast tego endpointu browser:

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}'

Odpowiedź z przeglądarki używa pola body zamiast data:

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

Common Issues

Problem Solution
Pusta zawartość Przełącz się z endpointu single na browser: strona prawdopodobnie wymaga renderowania JS
CAPTCHA w odpowiedzi Przełącz się na endpoint proxy, aby skorzystać z automatycznej rotacji IP
Timeout Zwiększ timeout_ms lub upewnij się, że URL jest poprawny

Next Steps

Aktualizacja: 1 lipca 2026
← Przegląd panelu Zarządzanie kluczami API →