Първа заявка

Това ръководство ще ви преведе през създаването на API key и изпращането на първата ви request с помощта на FourA Dashboard.

Стъпка 1: Отворете Dashboard

Отидете на Dashboard и влезте с вашия FourA акаунт.

Стъпка 2: Създайте API Key

Отидете на страницата API Keys и кликнете върху Create Key.

Дайте на ключа описателно име (напр. "production-scraper" или "dev-testing"). Пълният ключ се показва само веднъж, затова го копирайте веднага.

Вашият ключ изглежда така: pk_live_a1b2c3d4e5f6...

Стъпка 3: Изберете Endpoint

FourA има три endpoints за различни сценарии:

Single (`POST /api/single/`)

Изпраща бърза HTTP request. Най-подходящ за статични HTML страници и API endpoints. Време за response: обикновено под 2 секунди.

Browser (`POST /api/browser/`)

Стартира Chrome browser инстанция за рендериране на JavaScript. Най-подходящ за SPAs, lazy-loaded съдържание и страници, които изискват изпълнение на JS. Време за response: от 2 до 10 секунди.

Proxy (`POST /api/proxy/`)

Маршрутизира request през ротиращи proxies с автоматичен повторен опит. Най-подходящ за сайтове с bot detection или гео-ограничено съдържание.

Стъпка 4: Изпратете вашата първа Request

Отворете терминал и изпълнете:

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

Стъпка 5: Прочетете Response

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

Ключови полета:

status: HTTP status код от целевия сайт
data: response body (HTML, JSON или чист текст)
total_time: продължителност на request в секунди

Стъпка 6: Опитайте Browser Request

Ако целевата страница използва JavaScript за рендериране на съдържанието, използвайте browser endpoint вместо това:

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

Browser response използва body вместо data:

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

Често срещани проблеми

Проблем	Решение
Празно съдържание	Преминете от single към browser endpoint: страницата вероятно се нуждае от JS рендериране
CAPTCHA в response	Преминете към proxy endpoint за автоматична ротация на IP
Timeout	Увеличете `timeout_ms` или проверете дали URL е правилен

Следващи стъпки

Преглед на Dashboard: Пълно ръководство за Dashboard
Playground: Тествайте requests в Dashboard, преди да пишете код
Избор на правилния Endpoint: Подробно сравнение
Често срещани проблеми: Бързо разрешаване на проблеми

Обновено: 1 юли 2026 г.