Docs › Първи стъпки › Бърз старт

Бърз старт

Преминете от нулата до първото си събиране на данни за по-малко от две минути.

Предварителни изисквания

Стъпка 1: Вземете своя API ключ

Влезте в Dashboard и създайте API ключ. Той изглежда така: pk_live_a1b2c3d4e5f6...

Копирайте го. Ще ви е необходим за всяка заявка.

Стъпка 2: Направете първата си заявка

Отворете терминал и изпълнете това (заменете YOUR_API_KEY с вашия действителен ключ):

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

Това изпраща HTTP заявка към example.com и връща HTML на страницата.

Стъпка 3: Прочетете отговора

{
  "status": 200,
  "headers": [
    {
      "result": { "version": "HTTP/2", "code": 200, "reason": "" },
      "content-type": "text/html; charset=UTF-8",
      "content-length": "1256"
    }
  ],
  "data": "<!doctype html><html>...</html>",
  "total_time": 0.45
}

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

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

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

Стъпка 4: Опитайте различни endpoints

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

Endpoint Скорост Използвайте, когато
POST /api/auto/ Варира (бързо при топли хостове) Не знаете кой енджин е нужен на сайта. Подайте URL и оставете FourA да избере най-евтиния път, който работи.
POST /api/single/ Най-бързо (200ms-2s) Статични страници, APIs, рендирани на сървъра сайтове
POST /api/browser/ Средно (2s-10s) Страници с много JavaScript, SPAs, динамично съдържание
POST /api/proxy/ Бързо (1s-5s) Сайтове със защита от ботове, гео-блокирано съдържание

Опитайте auto заявка (интелигентната опция по подразбиране):

curl -X POST https://eu.api.foura.ai/api/auto/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/product/42",
    "validate": {"data": {"accept": ["Add to cart"]}}
  }'

Опитайте 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}'

Опитайте proxy заявка (автоматична ротация на 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
    }
  }'

Какво следва

Обновено: 1 юли 2026 г.
Удостоверяване →