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

> URL: https://foura.ai/ru/docs/getting-started/quick-start
> Updated: 2026-09-27
> Index: https://foura.ai/llms.txt

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

## Требования

- Аккаунт FourA ([зарегистрируйтесь здесь](https://foura.ai))
- Ваш API key (создайте его в [Dashboard](https://foura.ai/dashboard))

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

Войдите в [Dashboard](https://foura.ai/dashboard) и создайте API key. Он выглядит так: `pk_live_a1b2c3d4e5f6...`

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

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

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

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

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

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

```json
{
  "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 (интеллектуальный вариант по умолчанию):

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

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

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

```bash
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
    }
  }'
```

## Что дальше

- [Authentication](https://foura.ai/docs/getting-started/authentication): управление API key и безопасность
- [API Endpoints](https://foura.ai/docs/api/endpoints): полный справочник параметров для всех четырех endpoint
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): как auto endpoint выбирает действие
- [SDKs and Libraries](https://foura.ai/docs/getting-started/sdks-and-libraries): примеры для Python, Node.js, Go, Ruby
- [Choosing the Right Endpoint](https://foura.ai/docs/guides/choosing-task-type): когда выбирать auto, single, browser или proxy
