Документация › Начало работы › Быстрый старт

Быстрый старт

Перейдите от нуля к первому сбору данных менее чем за две минуты.

Требования

Шаг 1: Получите API key

Войдите в Dashboard и создайте API key. Он выглядит так: pk_live_a1b2c3d4e5f6...

Скопируйте его. Он понадобится для каждого request.

Шаг 2: Выполните первый request

Откройте терминал и выполните следующую команду (замените YOUR_API_KEY на ваш реальный ключ):

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"}'

Отправляет HTTP-request на example.com и возвращает HTML страницы.

Шаг 3. Чтение response

{
  "status": 200,
  "headers": [
    {
      "result": { "version": "HTTP/2", "code": 200, "reason": "" },
      "content-type": "text/html; charset=UTF-8",
      "content-length": "1256"
    }
  ],
  "data": "<!doctype html><html>...</html>",
  "total_time": 0.45
}

Поле headers представляет собой массив объектов, по одному на каждый шаг редиректа. Каждая запись содержит поле result со строкой статуса и всеми заголовками ответа, возвращенными целевым ресурсом для этого шага.

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

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

Шаг 4. Попробуйте разные endpoints

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

Endpoint Скорость Когда использовать
POST /api/auto/ Варьируется (быстро на прогретых хостах) Вы не знаете, какой движок требуется сайту. Передайте URL, и FourA выберет наиболее экономичный рабочий путь.
POST /api/single/ Самый быстрый (200ms-2s) Статические страницы, API, сайты с рендерингом на стороне сервера
POST /api/browser/ Средний (2s-10s) Страницы с большим объемом JavaScript, SPA, динамический контент
POST /api/proxy/ Быстрый (1s-5s) Сайты с проверкой источника запросов, контент с разделением по странам

Попробуйте выполнить auto request (интеллектуальный вариант по умолчанию):

curl -X POST https://eu.api.foura.ai/api/auto/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/product/42",
    "validate": {"data": {"accept": ["Add to cart"]}}
  }'

Попробуйте выполнить browser request:

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", "timeout_ms": 15000}'

Попробуйте proxy request (автоматическая ротация proxy):

curl -X POST https://eu.api.foura.ai/api/proxy/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "maxTries": 3,
    "request": {
      "method": "GET",
      "url": "https://example.com",
      "unblocker": true
    }
  }'

Что дальше

Обновлено: 27 сентября 2026 г.
Аутентификация →