Dokumentacja › Pierwsze kroki › Szybki start

Szybki start

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

Wymagania wstępne

Krok 1: Uzyskaj klucz API

Zaloguj się do Panelu i utwórz klucz API. Wygląda on tak: pk_live_a1b2c3d4e5f6...

Skopiuj go. Będzie potrzebny na każdy request.

Krok 2: Wykonaj swój pierwszy request

Otwórz terminal i uruchom poniższe polecenie (zastąp YOUR_API_KEY swoim właściwym 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 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 obiektów, po jednym na każde przekierowanie. Każdy wpis zawiera pole result z linią statusu oraz każdy header z response, który cel zwrócił dla tego przekierowania.

Kluczowe pola:

  • status: kod statusu HTTP z docelowej strony
  • data: ciało response (HTML, JSON lub czysty tekst)
  • total_time: czas trwania request w sekundach

Krok 4: Wypróbuj różne endpointy

FourA posiada cztery endpointy dla różnych sytuacji:

Endpoint Szybkość Kiedy używać
POST /api/auto/ Zmienna (szybko na rozgrzanych hostach) Nie wiesz, jakiego silnika potrzebuje strona. Przekaż URL i pozwól FourA wybrać najtańszą działającą ścieżkę.
POST /api/single/ Najwyższa (200ms-2s) Strony statyczne, API, witryny renderowane po stronie serwera
POST /api/browser/ Średnia (2s-10s) Strony oparte na JavaScript, SPA, zawartość dynamiczna
POST /api/proxy/ Wysoka (1s-5s) Strony z wykrywaniem botów, treści z ograniczeniami regionalnymi

Wypróbuj auto request (inteligentna wartość domyślna):

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 browser request:

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 proxy request (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: 1 lipca 2026
Uwierzytelnianie →