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 Dashboard i utwórz klucz API. Wygląda on tak: pk_live_a1b2c3d4e5f6...

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

Krok 2: Wyślij swój pierwszy request

Otwórz terminal i uruchom to 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"}'

To wyśle request HTTP do example.com i zwróci kod HTML strony.

Krok 3: Odczytaj response

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

Kluczowe pola:

  • status: kod statusu HTTP z docelowej witryny
  • data: body response (HTML, JSON lub zwykły tekst)
  • total_time: czas trwania requestu w sekundach

Krok 4: Wypróbuj różne endpointy

FourA oferuje trzy endpointy do różnych zastosowań:

Endpoint Szybkość Kiedy używać
POST /api/single/ Najszybszy (200ms-2s) Statyczne strony, API, witryny renderowane po stronie serwera
POST /api/browser/ Średni (2s-10s) Strony bogate w JavaScript, aplikacje SPA, dynamiczna zawartość
POST /api/proxy/ Szybki (1s-5s) Witryny z detekcją botów, treści z ograniczeniami geograficznymi

Wypróbuj request typu 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", "timeout_ms": 15000}'

Wypróbuj request typu 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: 1 lipca 2026
Uwierzytelnianie →