Создание задачи

Это руководство проведет вас через процесс создания 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 есть четыре endpoint для разных сценариев:

Auto (`POST /api/auto/`)

Умный выбор по умолчанию. Передайте URL и правило validate, и FourA выберет самый дешевый рабочий путь: прямой запрос, вращающийся proxy или полный браузер. Лучше всего подходит, когда вы нацеливаетесь на новый сайт и еще не знаете, что ему нужно.

Single (`POST /api/single/`)

Отправляет быстрый HTTP запрос. Лучше всего подходит для статических HTML страниц и API endpoint. Время ответа: обычно менее 2 секунд.

Browser (`POST /api/browser/`)

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

Proxy (`POST /api/proxy/`)

Маршрутизирует запрос через вращающиеся proxy с автоматическим повтором. Лучше всего подходит для сайтов с обнаружением ботов или контентом, ограниченным по географическому признаку.

Шаг 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 со строкой статуса, а также каждым заголовком ответа, который вернул целевой сайт.

Ключевые поля:

status: HTTP статус код от целевого сайта
data: тело ответа (HTML, JSON или необработанный текст)
total_time: продолжительность запроса в секундах

Шаг 6: Попробуйте запрос через Browser

Если целевая страница использует 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>"
}

Распространенные проблемы

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

Следующие шаги

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

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