Первый запрос

Это руководство поможет вам создать API-ключ и отправить первый request с помощью FourA Dashboard.

Шаг 1: Откройте Dashboard

Перейдите в Dashboard и войдите в свой аккаунт FourA.

Шаг 2: Создайте API-ключ

Перейдите на страницу API Keys и нажмите Create Key.

Укажите понятное имя для ключа (например, "production-scraper" или "dev-testing"). Полный ключ отображается только один раз, поэтому сразу скопируйте его.

Ваш ключ выглядит так: pk_live_a1b2c3d4e5f6...

Шаг 3: Выберите endpoint

FourA предлагает три endpoint для различных сценариев:

Single (`POST /api/single/`)

Отправляет быстрый HTTP request. Подходит для статических HTML-страниц и API endpoints. Время response: обычно менее 2 секунд.

Browser (`POST /api/browser/`)

Запускает экземпляр браузера Chrome для рендеринга JavaScript. Подходит для SPA, ленивой загрузки контента и страниц, требующих выполнения JS. Время response: от 2 до 10 секунд.

Proxy (`POST /api/proxy/`)

Маршрутизирует request через ротируемые proxy с автоматическим повтором. Подходит для сайтов с защитой от ботов или гео-ограничениями.

Шаг 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-код статуса целевого сайта
data: тело response (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 вместо data используется body:

{
  "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 г.