# Удостоверяване

> URL: https://foura.ai/bg/docs/getting-started/authentication
> Updated: 2026-10-29
> Index: https://foura.ai/llms.txt

Всяка заявка към FourA API изисква автентикация. Тази страница обяснява как да получите, използвате и управлявате своя API key.

## Получаване на вашия API key

1. Влезте в [FourA Dashboard](https://foura.ai/dashboard)
2. Отидете на страницата **API Keys**
3. Кликнете върху **Create Key**
4. Копирайте ключа от диалоговия прозорец за потвърждение

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

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

## Използване на вашия API key

Включвайте вашия API key в заглавката `X-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"}'
```

В Python:

```python
import requests

response = requests.post(
    "https://eu.api.foura.ai/api/single/",
    headers={
        "X-API-Key": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={"method": "GET", "url": "https://example.com"}
)
```

В Node.js:

```javascript
const response = await fetch('https://eu.api.foura.ai/api/single/', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ method: 'GET', url: 'https://example.com' })
});
```

## Сигурност на API ключа

Третирайте вашия API ключ като парола:

- **Не го качвайте в системи за контрол на версиите.** Използвайте променливи на средата.
- **Не го излагайте в клиентски код.** Използвайте го само в сървърни приложения.
- **Сменете го при компрометиране.** Генерирайте ключа отново от Dashboard. Старият ключ спира да работи в рамките на минута, а всяко показване се записва в одит лог, така че откраднатите идентификационни данни се откриват лесно впоследствие.

### Използване на променливи на средата

Съхранявайте ключа си в променлива на средата:

```bash
export FOURA_API_KEY="pk_live_a1b2c3d4e5f6..."
```

След това реферирайте към него във вашия код:

```python
import os
api_key = os.environ["FOURA_API_KEY"]
```

```javascript
const apiKey = process.env.FOURA_API_KEY;
```

## Чести грешки при автентикация

Всички неуспешни автентикации връщат статус `401 Unauthorized`.

| Грешка | Съобщение | Причина | Решение |
|-------|---------|-------|-----|
| 401 | Missing API key. Include X-API-Key header. | Липсва заглавка `X-API-Key` в заявката | Добавете заглавката `X-API-Key` |
| 401 | Invalid API key | Грешен ключ, излишни интервали или деактивиран ключ | Проверете ключа, премахнете празните пространства или създайте нов ключ от Dashboard |

Ако FourA не може да провери ключ за момент, например по време на превключване на базата данни, връща `503` с `API key check temporarily unavailable` и `Retry-After: 5`, никога `401`. Опитайте отново след това изчакване: ключът ви е наред.

Всеки отговор, успешен или неуспешен, съдържа заглавка `X-Foura-Request-Id`, освен при тяло, което FourA изобщо не може да разчете (невалиден JSON или тяло над 100 KB), което се отхвърля преди присвояване на ID. Записвайте го в логовете от ваша страна, за да може поддръжката да намери конкретното повикване по-късно.

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

- [Бърз старт](https://foura.ai/docs/getting-started/quick-start): Направете първата си заявка
- [Управление на API ключове](https://foura.ai/docs/dashboard/api-keys): Показване, редактиране, прегенериране и изтриване на ключове
- [API крайни точки](https://foura.ai/docs/api/endpoints): Пълна документация за крайните точки
- [Обработка на грешки](https://foura.ai/docs/api/errors): Елегантно справяне с грешки при автентикация
