Перейти к основному содержанию

​
Формат ошибок

Все ошибки возвращают JSON-ответ с полем detail: 
{
  "detail": "Insufficient balance"
}
Некоторые ошибки содержат структурированный code для программной обработки: 
{
  "detail": {
    "error": {
      "code": "INSUFFICIENT_BALANCE",
      "message": "Not enough TRX balance"
    }
  }
}

​
HTTP-коды статусов

КодЗначение
200Успех
400Некорректный запрос — неверные параметры
401Не авторизован — отсутствует или недействительный API-ключ
403Запрещено — ключ отключён или действие не разрешено
404Не найдено
409Конфликт — дублирующий запрос или конфликт ресурсов
422Ошибка валидации — проверьте тело запроса
429Превышен лимит запросов
500Ошибка сервера

​
Распространённые коды ошибок

КодОписание
INSUFFICIENT_BALANCEНедостаточно средств на балансе для этой операции
ADDRESS_ALREADY_ACTIVESmart Mode уже активен для этого адреса
ORDER_NOT_FOUNDЗаказ с указанным ID не существует
INVALID_ADDRESSНедействительный адрес TRON
RATE_LIMITEDСлишком много запросов, повторите после паузы
PASSKEY_REQUIREDДля вывода средств требуется верификация passkey
2FA_REQUIREDДля вывода средств требуется код 2FA

​
Стратегия повторных запросов

Для ошибок 429 и 5xx используйте экспоненциальную задержку: 
import time
import requests

def api_call_with_retry(url, **kwargs):
    for attempt in range(3):
        resp = requests.get(url, **kwargs)
        if resp.status_code == 429 or resp.status_code >= 500:
            time.sleep(2 ** attempt)
            continue
        return resp
    raise Exception("Max retries exceeded")