Создание задачи
Это руководство поможет вам создать 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, чтобы отобразить его, или перевыпустите ключ, если он устаревший |
Следующие шаги
- Обзор панели управления: Полный обзор интерфейса
- Песочница: Тестирование запросов в панели до написания кода
- Smart Fetch (Auto): Подробный разбор endpoint auto
- Выбор подходящего endpoint: Подробное сравнение
- Частые проблемы: Быстрое решение неполадок