# Tworzenie zadania

> URL: https://foura.ai/pl/docs/dashboard/creating-a-task
> Updated: 2026-10-28
> Index: https://foura.ai/llms.txt

Ten przewodnik przeprowadzi Cię przez proces tworzenia klucza API i wysyłania pierwszego żądania za pomocą FourA Dashboard.

## Krok 1: Otwórz Dashboard

Przejdź do [Dashboard](https://foura.ai/dashboard) i zaloguj się na swoje konto FourA.

## Krok 2: Utwórz klucz API

Przejdź do strony **API Keys** i kliknij **Create API key**. Gdy masz już klucz, przycisk nad listą ma etykietę **Create Key**.

Nadaj kluczowi opisową nazwę (np. "production-scraper" lub "dev-testing"). Okno dialogowe **API Key Created** wyświetla jawny klucz wraz z przyciskiem kopiowania, a w sekcji **Test your first request** gotowe do uruchomienia polecenie curl z przyciskiem **Copy command**. Na telefonie lub tablecie opcja **Try it in the Playground** przeniesie Cię bezpośrednio na tę stronę.

Jeśli to pominiesz, kliknij później ikonę oka w wierszu klucza, aby wyświetlić go ponownie. Starsze klucze, utworzone przed wprowadzeniem funkcji podglądu, nie mogą zostać przywrócone; wygeneruj je ponownie, aby przejść na nowy system. Pełny opis procedury: [Managing API Keys](https://foura.ai/docs/dashboard/api-keys).

Twój klucz wygląda następująco: `pk_live_a1b2c3d4e5f6...`

## Krok 3: Wybierz endpoint

FourA oferuje cztery endpointy dla różnych scenariuszy:

### Auto (`POST /api/auto/`)

Inteligentny wybór domyślny. Przekaż URL, najlepiej z regułą `validate`, a FourA przechodzi po kolei od rotującego proxy do pełnej przeglądarki przez proxy, zatrzymując się na pierwszej odpowiedzi spełniającej warunki. Ustaw `forceProxy: false`, aby najpierw spróbować żądania bezpośredniego. Najlepsze rozwiązanie, gdy pracujesz z nową witryną i jeszcze nie wiesz, czego wymaga.

### Single (`POST /api/single/`)

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

### Browser (`POST /api/browser/`)

Uruchamia instancję przeglądarki Chrome, aby renderować JavaScript. Najlepsze dla aplikacji SPA, leniwie ładowanej zawartości i stron wymagających wykonania kodu JS. Czas odpowiedzi: od 2 do 10 sekund.

### Proxy (`POST /api/proxy/`)

Kieruje żądanie przez rotujące serwery proxy z automatycznym ponawianiem. Najlepsze dla stron, które weryfikują źródło zapytań lub zwracają różne odpowiedzi w zależności od kraju.

## Krok 4: Wyślij swoje pierwsze żądanie

Otwórz terminal i uruchom:

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

## Krok 5: Odczytanie odpowiedzi

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

Pole `headers` jest tablica obiektow, po jednym dla kazdego przeskoku przekierowania (hop). Kazdy wpis zawiera `result` z linia statusu oraz wszystkimi naglowkami response zwroconymi przez cel.

Kluczowe pola:
- **status**: kod statusu HTTP ze strony docelowej
- **data**: tresc response (HTML, JSON lub zwykly tekst)
- **total_time**: czas trwania request w sekundach

## Krok 6: Wyprobuj request przez przegladarke

Jesli strona docelowa uzywa JavaScriptu do renderowania tresci, uzyj zamiast tego endpointu przegladarki:

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

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

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

## Typowe problemy

| Problem | Rozwiązanie |
|---------|----------|
| Nie wiesz, którego silnika użyć | Zacznij od endpointu auto. Wybiera właściwą ścieżkę i zapamiętuje, co zadziałało. |
| Pusta treść | Przełącz się z endpointu single na browser: strona prawdopodobnie wymaga renderowania JS |
| Strona weryfikacji w odpowiedzi | Przełącz się na endpoint proxy, aby korzystać z automatycznej rotacji IP |
| Przekroczenie limitu czasu (timeout) | Zwiększ `timeout_ms` lub sprawdź, czy URL jest poprawny |
| Zgubiony klucz | Kliknij ikonę oka w wierszu klucza w sekcji **API Keys**, aby go odkryć, lub wygeneruj nowy, jeśli to klucz starszego typu |

## Kolejne kroki

- [Dashboard Overview](https://foura.ai/docs/dashboard/overview): Pełne omówienie panelu
- [Playground](https://foura.ai/docs/dashboard/playground): Testuj żądania w panelu przed napisaniem kodu
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): Szczegółowe omówienie endpointu auto
- [Choosing the Right Endpoint](https://foura.ai/docs/guides/choosing-task-type): Szczegółowe porównanie
- [Common Issues](https://foura.ai/docs/troubleshooting/common-issues): Szybkie rozwiązywanie problemów
