Коды ошибок
Эта страница содержит информацию о кодах ошибок, которые могут быть возвращены API TronZap.
Формат ответа с ошибкой
При возникновении ошибки API вернет ответ с ненулевым кодом ошибки и описанием ошибки:
json
{
"code": 1,
"error": "Описание ошибки"
}Список кодов ошибок
| Код | Описание | Решение |
|---|---|---|
| 0 | Успех | Не является ошибкой. Запрос выполнен успешно. |
| 1 | Ошибка аутентификации | Проверьте ваш API-токен и убедитесь, что подпись рассчитана правильно. |
| 2 | Неверный сервис или параметры | Проверьте правильность названия сервиса и параметров. |
| 5 | Кошелек не найден | Проверьте адрес кошелька или обратитесь в поддержку, если считаете это ошибкой. |
| 6 | Недостаточно средств | Пополните счет или уменьшите запрашиваемое количество энергии. |
| 10 | Неверный TRON-адрес | Проверьте формат TRON-адреса. Это должен быть валидный 34-символьный TRON-адрес. |
| 11 | Неверное количество энергии | Убедитесь, что запрашиваемое количество энергии валидно. |
| 12 | Неверная длительность | Проверьте правильность параметра длительности. |
| 20 | Транзакция не найдена | Проверьте правильность ID транзакции или внешнего ID. |
| 24 | Адрес не активирован | Сначала активируйте адрес, создав транзакцию активации адреса. |
| 25 | Адрес уже активирован | Адрес уже активирован. Действия не требуются. |
| 500 | Внутренняя ошибка сервера | Обратитесь в поддержку, если эта ошибка повторяется. |
Обработка ошибок
При использовании API вам следует реализовать логику обработки ошибок для всех возможных кодов ошибок. Вот некоторые рекомендации:
Ошибки аутентификации (Код 1)
Ошибки аутентификации указывают на проблемы с вашими учетными данными API или расчетом подписи. Вам следует:
- Проверить правильность API-токена
- Проверить логику расчета подписи
- Убедиться, что ваш API-секрет не раскрыт в клиентском коде
Ошибки ресурсов (Коды 5, 6, 10, 20)
Ошибки ресурсов указывают на проблемы с предоставленными ресурсами. Вам следует:
- Проверять TRON-адреса перед отправкой в API
- Проверять баланс счета перед совершением транзакций
- Проверять ID транзакций при проверке статуса
Ошибки бизнес-логики (Коды 24, 25)
Ошибки бизнес-логики указывают на проблемы с запрашиваемой операцией. Вам следует:
- Реализовать проверку активации адреса перед попыткой покупки энергии
- Пропускать активацию адреса, если он уже активирован