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

> URL: https://foura.ai/ru/docs/dashboard/creating-a-task
> Updated: 2026-10-28
> Index: https://foura.ai/llms.txt

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

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

Перейдите в [Dashboard](https://foura.ai/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](https://foura.ai/docs/dashboard/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

Откройте терминал и выполните команду:

```bash
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: Чтение ответа

```json
{
  "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 браузера:

```bash
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`:

```json
{
  "status": 200,
  "headers": {"content-type": "text/html"},
  "body": "<html>...</html>"
}
```

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

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

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

- [Обзор панели управления](https://foura.ai/docs/dashboard/overview): Полный обзор интерфейса
- [Песочница](https://foura.ai/docs/dashboard/playground): Тестирование запросов в панели до написания кода
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): Подробный разбор endpoint auto
- [Выбор подходящего endpoint](https://foura.ai/docs/guides/choosing-task-type): Подробное сравнение
- [Частые проблемы](https://foura.ai/docs/troubleshooting/common-issues): Быстрое решение неполадок
