> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taimly.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Аутентификация

> Как авторизовать запросы к Taimly API

## Обзор

Taimly API использует **Bearer-токены** для аутентификации. Каждый запрос должен содержать заголовок `Authorization` с вашим API-ключом.

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Получение API-ключа

API-ключи выдаются **администратором сервиса**. Для получения ключа свяжитесь с администратором Taimly.

<Warning>
  Храните API-ключ в безопасном месте — переменных окружения или менеджере секретов. Не вставляйте ключ напрямую в код.
</Warning>

## Использование

Передавайте ключ в заголовке `Authorization` каждого запроса:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://taimly.net/api/spam-check/start \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  headers = {"Authorization": "Bearer YOUR_API_KEY"}

  response = requests.post(
      "https://taimly.net/api/spam-check/start",
      headers=headers
  )
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch("https://taimly.net/api/spam-check/start", {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  });
  ```
</CodeGroup>

## Срок действия

API-ключ действует **365 дней** с момента выдачи. После истечения срока запросите новый ключ у администратора.

## Ошибки аутентификации

Если ключ невалиден, отсутствует или истёк — API вернёт `401`:

```json theme={null}
{
  "detail": "Invalid or missing API key"
}
```

<Tip>
  Используйте переменные окружения для хранения ключа. Например, в `.env` файле: `TAIMLY_API_KEY=your_key_here`
</Tip>