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

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

> Как аутентифицироваться в TronRental API

## Аутентификация по API-ключу

Все API-запросы требуют передачи API-ключа в заголовке `X-API-Key`.

```bash theme={null}
curl https://api.tronrental.com/v1/account/balance \
  -H "X-API-Key: your_api_key"
```

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

1. Зарегистрируйтесь на [tronrental.com](https://tronrental.com/auth/register)
2. Перейдите в [Личный кабинет → API-ключи](https://tronrental.com/dashboard/api)
3. Нажмите **Создать API-ключ**
4. Скопируйте и надёжно сохраните ключ — он показывается только один раз

### Белый список IP (опционально)

Вы можете ограничить API-ключ определёнными IP-адресами для дополнительной безопасности. Настройте это в личном кабинете при создании или редактировании ключа.

### Разрешения ключа

Каждый API-ключ имеет полный доступ ко всем API-операциям вашего аккаунта:

* Покупка энергии и bandwidth
* Управление подписками Smart Mode
* Создание инвойсов
* Проверка баланса и истории транзакций

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

## Лимиты запросов

API-ключи имеют лимиты запросов по каждому эндпоинту. Подробности см. в разделе [Лимиты запросов](/resources/rate-limits).

## Ошибки

Ошибки аутентификации возвращают HTTP `401`:

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

Если ваш ключ отключён или заблокирован, вы получите HTTP `403`.