Създаване на задача

Това ръководство ви превежда през създаването на API ключ и изпращането на първата ви заявка чрез FourA Dashboard.

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

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

Стъпка 2: Създайте API ключ

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

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

Ако го пропуснете, кликнете върху иконата с око на реда на ключа по-късно, за да го разкриете отново. Наследените ключове, създадени преди внедряването на функцията за разкриване, не могат да бъдат върнати; генерирайте ги отново, за да преминете към новата система. Пълен процес: Managing API Keys.

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

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

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

Auto (`POST /api/auto/`)

Интелигентната настройка по подразбиране. Подайте URL адрес плюс правило validate и FourA избира най-евтиния път, който работи: директна заявка, rotating proxy или пълен браузър. Най-доброто решение, когато насочвате към нов сайт и все още не знаете какво изисква той.

Single (`POST /api/single/`)

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

Browser (`POST /api/browser/`)

Стартира инстанция на браузъра Chrome, за да рендира JavaScript. Най-доброто за SPA, мързеливо зареждано съдържание (lazy-loaded content) и страници, които изискват изпълнение на JS. Време за отговор: от 2 до 10 секунди.

Proxy (`POST /api/proxy/`)

Насочва заявката през rotating proxies с автоматичен повторен опит. Най-доброто за сайтове с разпознаване на ботове или географски ограничено съдържание.

Стъпка 4: Изпратете първата си заявка

Отворете терминал и стартирайте:

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: Прочетете отговора

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

Полето headers е масив от обекти, по един за всеки скок на пренасочване. Всеки запис има result със статус линия плюс всеки response header, върнат от целта.

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

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

Стъпка 6: Опитайте заявка през браузър

Ако целевата страница използва 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}'

Отговорът от браузъра използва body вместо data:

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

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

Проблем	Решение
Не сте сигурни кой engine да използвате	Започнете с auto endpoint. Той избира правилния път и запомня кое е проработило.
Празно съдържание	Преминете от single към browser endpoint: страницата вероятно се нуждае от рендиране на JS
Captcha в отговора	Преминете към proxy endpoint за автоматична ротация на IP адреси
Timeout	Увеличете `timeout_ms` или проверете дали URL адресът е правилен
Загубили сте ключа си	Кликнете върху иконата с око на реда на ключа в API Keys, за да го разкриете, или го генерирайте отново, ако ключът е наследен

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

Dashboard Overview: Пълно ръководство за dashboard
Playground: Тествайте заявки в dashboard преди да пишете код
Smart Fetch (Auto): Подробен преглед на auto endpoint
Choosing the Right Endpoint: Подробно сравнение
Common Issues: Решаване на проблеми бързо

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