Tworzenie zadania
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 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.
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:
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
{
"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:
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:
{
"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: Pełne omówienie panelu
- Playground: Testuj żądania w panelu przed napisaniem kodu
- Smart Fetch (Auto): Szczegółowe omówienie endpointu auto
- Choosing the Right Endpoint: Szczegółowe porównanie
- Common Issues: Szybkie rozwiązywanie problemów