# Szybki start

> URL: https://foura.ai/pl/docs/getting-started/quick-start
> Updated: 2026-09-27
> Index: https://foura.ai/llms.txt

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

## Wymagania wstępne

- Konto FourA ([zarejestruj się tutaj](https://foura.ai))
- Twój klucz API (utwórz go w [Dashboardzie](https://foura.ai/dashboard))

## Krok 1: Pobierz swój klucz API

Zaloguj się do [Dashboardu](https://foura.ai/dashboard) 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):

```bash
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

```json
{
  "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):

```bash
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:

```bash
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):

```bash
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

- [Uwierzytelnianie](https://foura.ai/docs/getting-started/authentication): Zarządzanie kluczami API i bezpieczeństwo
- [Endpointy API](https://foura.ai/docs/api/endpoints): Pełna dokumentacja parametrów dla wszystkich czterech endpointów
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): Jak endpoint auto podejmuje decyzje
- [SDK i biblioteki](https://foura.ai/docs/getting-started/sdks-and-libraries): Przykłady w językach Python, Node.js, Go, Ruby
- [Wybór odpowiedniego endpointu](https://foura.ai/docs/guides/choosing-task-type): Kiedy wybrać auto, single, browser lub proxy
