Аутентификация по API-ключу
Все API-запросы требуют передачи API-ключа в заголовкеX-API-Key.
Получение API-ключа
- Зарегистрируйтесь на tronrental.com
- Перейдите в Личный кабинет → API-ключи
- Нажмите Создать API-ключ
- Скопируйте и надёжно сохраните ключ — он показывается только один раз
Белый список IP (опционально)
Вы можете ограничить API-ключ определёнными IP-адресами для дополнительной безопасности. Настройте это в личном кабинете при создании или редактировании ключа.Разрешения ключа
Каждый API-ключ несёт разрешения (scopes) — операции, которые ему доступны. Их выбирают в личном кабинете при создании или редактировании ключа. Новый ключ получает все разрешения на чтение и запись (покупка энергии и bandwidth, Smart Mode, просмотр баланса и истории и другие), кромеwithdraw:
его включают отдельно, и для этого нужны 2FA и белый список IP. Запрос вне разрешений ключа получает
HTTP 403. Полный список: Список разрешений API-ключа.
Ключи Node API
Node API — доступ к полным нодам TRON наnode.tronrental.com — использует
собственные ключи. Их создают как эндпоинты в разделе
Личный кабинет → Node API. Ключ Node API работает только
на ноде: этот API отвечает на него 403 NODE_API_KEY_ONLY. API-ключи, описанные на этой странице, на
ноде тоже не работают. См. Node API → Эндпоинты и ключи.
Использование ключа и журнал запросов
Каждый запрос, аутентифицированный API-ключом, сохраняется на 7 дней: метод, путь, код ответа, задержка и IP клиента. Параметры запроса (query string) в этом журнале не показываются. Откройте Dashboard → API Keys и разверните ключ, чтобы увидеть его последние запросы; колонка Last Used показывает самый свежий вызов (отметка при аутентификации обновляется не чаще раза в 5 минут, журнал точен). Журнал доступен только из кабинета — API-ключ не может прочитать собственный журнал.Лимиты запросов
Лимиты запросов считаются по аккаунту, а не по ключу: все ключи одного аккаунта делят общий бюджет. Подробности см. в разделе Лимиты запросов.Ошибки
Ошибки аутентификации возвращают HTTP401:
403.