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

Это руководство поможет вам создать API key и отправить первый request с помощью 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 предлагает четыре endpoint для различных задач:

Auto (POST /api/auto/)

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

Single (POST /api/single/)

Отправляет быстрый HTTP request. Лучше всего подходит для статических HTML-страниц и API endpoints. Время ответа: обычно менее 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. Чтение response

{
  "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. Попробуйте выполнить запрос через браузер

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

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

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

• Обзор панели управления: Полный разбор возможностей панели
• Playground: Тестирование запросов в панели до написания кода
• Smart Fetch (Auto): Подробный разбор auto endpoint
• Выбор подходящего endpoint: Детальное сравнение
• Частые проблемы: Быстрое решение неполадок