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

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

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

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

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

Отидете на страницата API Keys и кликнете върху Create API key. След като имате ключ, бутонът над списъка се променя на Create Key.

Задайте описателно име на ключа (напр. "production-scraper" или "dev-testing"). Диалоговият прозорец API Key Created показва нешифрования ключ с бутон за копиране, а под Test your first request има готова за изпълнение curl команда с Copy command. На телефон или таблет Try it in the Playground ви отвежда директно там.

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

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

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

FourA предлага четири endpoints за различни сценарии:

Auto (POST /api/auto/)

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

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/)

Маршрутизира заявката през rotating proxies с автоматичен retry. Подходящ за сайтове, които проверяват източника на заявката или връщат различно съдържание според държавата.

Стъпка 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 е масив от обекти, по един за всяка стъпка на пренасочване (redirect hop). Всеки запис съдържа result със статус реда плюс всеки response header, върнат от целевия сайт.

Основни полета:

• status: HTTP статус код от целевия сайт
• data: тялото на отговора (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>"
}

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

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

• Преглед на таблото: Пълен преглед на таблото
• Playground: Тествайте заявки в таблото, преди да пишете код
• Smart Fetch (Auto): Подробен преглед на auto endpoint
• Избор на правилния endpoint: Подробно сравнение
• Често срещани проблеми: Бързо решаване на проблеми