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

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

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

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

Шаг 2: Создайте API key

Откройте страницу API Keys и нажмите Create API key. Когда у вас уже есть key, кнопка над списком называется Create Key.

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

Если вы пропустили этот шаг, нажмите на иконку глаза в строке ключа позже, чтобы отобразить его снова. Устаревшие ключи, созданные до появления функции просмотра, восстановить нельзя; перевыпустите их один раз для перехода на новый формат. Подробный процесс: Managing API Keys.

Ваш key выглядит следующим образом: pk_live_a1b2c3d4e5f6...

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

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

Auto (POST /api/auto/)

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

Single (POST /api/single/)

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

Browser (POST /api/browser/)

Запускает экземпляр браузера Chrome для рендеринга JavaScript. Лучше всего подходит для SPA, контента с отложенной загрузкой и страниц, требующих выполнения JS. Время ответа: от 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: Чтение ответа

{
  "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, возвращенными целевым сайтом.

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

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

Шаг 6. Попробуйте выполнить Browser Request

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

Частые проблемы

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

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

Обновлено: 28 октября 2026 г.