> ## 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.

# Список разрешений API-ключа

> Разрешения, которые может нести API-ключ, сгруппированные по видам

## Список разрешений API-ключа

Возвращает каталог разрешений API-ключей, сгруппированный так же, как в кабинете. Используйте его,
чтобы узнать допустимые имена разрешений.

Ключи Node API — отдельный вид ключей: они несут только разрешение `node_api`, никогда вместе с другими
разрешениями, и работают только на `node.tronrental.com`. Их создают как эндпоинты в разделе
[Личный кабинет → Node API](https://tronrental.com/dashboard/node-api); сколько их может быть, зависит
от вашего тарифа Node API. Ключ Node API не может вызвать этот эндпоинт — REST API отвечает на него
`403 NODE_API_KEY_ONLY`. См. [Node API → Эндпоинты и ключи](/ru/node-api/authentication).

### Ответ

**read** `string[]`

Разрешения на чтение: `view`, `deposit_view`

**node** `string[]`

Разрешение Node API: `node_api`. Ключ с ним не несёт других разрешений

**write** `string[]`

Разрешения, которые расходуют баланс или изменяют услуги: `buy_energy`, `buy_bandwidth`, `smart_mode`,
`transfer_packages`, `energy_resale`

**danger** `string[]`

`withdraw`. Чтобы включить его на ключе, нужны 2FA и непустой белый список IP

**default** `string[]`

Разрешения, которые получает новый ключ REST API, если ни одно не выбрано: все разрешения на чтение и
запись, кроме `withdraw`

**locked** `string[]`

Разрешения, которые всегда есть у любого ключа REST API: `view`

### Пример

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

```json Response theme={null}
{
  "read": ["view", "deposit_view"],
  "node": ["node_api"],
  "write": ["buy_energy", "buy_bandwidth", "smart_mode", "transfer_packages", "energy_resale"],
  "danger": ["withdraw"],
  "default": ["view", "deposit_view", "buy_energy", "buy_bandwidth", "smart_mode", "transfer_packages", "energy_resale"],
  "locked": ["view"]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.