# Създаване на задача

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

Това ръководство ви превежда през създаването на API ключ и изпращането на първата ви заявка чрез FourA Dashboard.

## Стъпка 1: Отворете Dashboard

Отидете в [Dashboard](https://foura.ai/dashboard) и влезте с вашия FourA акаунт.

## Стъпка 2: Създайте API ключ

Отидете на страницата **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** ви отвежда директно там.

Ако пропуснете момента, по-късно щракнете върху иконата с око на реда на ключа, за да го видите отново. Стари ключове, създадени преди добавянето на показването, не могат да бъдат възстановени; прегенерирайте ги веднъж, за да преминете напред. Пълен процес: [Управление на API ключове](https://foura.ai/docs/dashboard/api-keys).

Вашият ключ изглежда така: `pk_live_a1b2c3d4e5f6...`

## Стъпка 3: Изберете endpoint

FourA предлага четири endpoint-а за различни сценарии:

### Auto (`POST /api/auto/`)

Интелигентният избор по подразбиране. Подайте URL, в идеалния случай с правило `validate`, и FourA преминава по стъпки от ротиращо proxy до пълен браузър през proxy, спирайки на първия отговор, който е успешен. Задайте `forceProxy: false`, за да опита първо с директна заявка. Най-добрият избор, когато обработвате нов сайт и все още не знаете от какво се нуждае.

### Single (`POST /api/single/`)

Изпраща бърза HTTP заявка. Най-подходящ за статични HTML страници и API endpoints. Време за отговор: обикновено под 2 секунди.

### Browser (`POST /api/browser/`)

Стартира инстанция на Chrome браузър за рендиране на JavaScript. Най-подходящ за SPA, съдържание с lazy loading и страници, изискващи изпълнение на JS. Време за отговор: от 2 до 10 секунди.

### Proxy (`POST /api/proxy/`)

Маршрутизира заявката през ротиращи проксита с автоматичен retry. Най-подходящ за сайтове, които проверяват източника на заявката, или връщат различно съдържание според държавата.

## Стъпка 4: Изпратете първата си заявка

Отворете терминал и изпълнете:

```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 header, върнат от целевия сайт.

Ключови полета:
- **status**: HTTP статус код от целевия сайт
- **data**: тялото на response (HTML, JSON или суров текст)
- **total_time**: продължителност на request в секунди

## Стъпка 6: Опитайте browser request

Ако целевата страница използва JavaScript за рендиране на съдържание, използвайте browser 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}'
```

Browser response използва `body` вместо `data`:

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

## Често срещани проблеми

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

## Следващи стъпки

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