Dokumentacja › Pierwsze kroki › Szybki start

Szybki start

Przejdź od zera do pierwszego pobrania danych w mniej niż dwie minuty.

Wymagania wstępne

Krok 1: Pobierz swój klucz API

Zaloguj się do Dashboardu i wygeneruj klucz API. Wygląda on następująco: pk_live_a1b2c3d4e5f6...

Skopiuj go. Będzie potrzebny do każdego requestu.

Krok 2: Wykonaj swój pierwszy request

Otwórz terminal i uruchom poniższe polecenie (zastąp YOUR_API_KEY swoim rzeczywistym kluczem):

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

Wysyła to request HTTP do example.com i zwraca kod HTML strony.

Krok 3: Odczytaj response

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

Pole headers to tablica obiektow, po jednym dla kazdego przekierowania. Kazdy wpis zawiera pole result z linia statusu oraz wszystkimi naglowkami odpowiedzi zwroconymi przez cel dla danego przeskoku.

Kluczowe pola:

  • status: kod statusu HTTP ze strony docelowej
  • data: cialo odpowiedzi (HTML, JSON lub czysty tekst)
  • total_time: czas trwania zadania w sekundach

Krok 4: Wyprobuj rozne endpointy

FourA oferuje cztery endpointy dla roznych scenariuszy:

Endpoint Predkosc Kiedy uzywac
POST /api/auto/ Zmienna (szybka na rozgrzanych hostach) Nie wiesz, jakiego silnika wymaga strona. Przekaz URL i pozwol FourA wybrac najtansza dzialajaca sciezke.
POST /api/single/ Najszybsza (200ms-2s) Strony statyczne, API, strony renderowane po stronie serwera
POST /api/browser/ Srednia (2s-10s) Strony z duza iloscia JavaScriptu, SPA, tresci dynamiczne
POST /api/proxy/ Szybka (1s-5s) Strony weryfikujace zrodlo zapytania, tresci zalezne od kraju

Wyprobuj zadanie auto (inteligentny domyslny wybor):

curl -X POST https://eu.api.foura.ai/api/auto/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/product/42",
    "validate": {"data": {"accept": ["Add to cart"]}}
  }'

Wypróbuj żądanie w przeglądarce:

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", "timeout_ms": 15000}'

Wypróbuj żądanie proxy (automatyczna rotacja proxy):

curl -X POST https://eu.api.foura.ai/api/proxy/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "maxTries": 3,
    "request": {
      "method": "GET",
      "url": "https://example.com",
      "unblocker": true
    }
  }'

Co dalej

Aktualizacja: 27 września 2026
Uwierzytelnianie →