Kody błędów

Gdy wywołanie API nie powiedzie się, odpowiedź zawiera niezerowy code i czytelny dla człowieka komunikat error.

Format odpowiedzi błędu

{
  "code": 60,
  "key": "address_from",
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "error": "Invalid TRON address"
}

Pole	Opis
code	Niezerowy kod błędu jako liczba całkowita.
key	Nazwa pola, które spowodowało błąd, jeśli dotyczy. W przeciwnym razie pusty ciąg.
request_id	Unikalny identyfikator żądania. Dołącz go podczas kontaktowania się z pomocą techniczną.
error	Czytelny dla człowieka opis błędu.

Kody statusu HTTP

Status HTTP	Znaczenie
200	Żądanie powiodło się (code: 0) lub błąd na poziomie aplikacji (code: non-zero).
429	Przekroczono limit zapytań — 1 żądanie/sekundę/IP na endpointach /v1/orders*.
422	Nieprzetworzone żądanie — walidacja nie powiodła się (zwracane również jako code: non-zero w treści).
500	Wewnętrzny błąd serwera — nieoczekiwany błąd po naszej stronie.

Typowe przypadki błędów

Sytuacja	Prawdopodobna przyczyna
Nieprawidłowy address_from lub address_to	Nie jest prawidłowym adresem TRON (musi zaczynać się od T, 34 znaki).
duration nie równa się 1	Obsługiwane są tylko wynajem 1-godzinny.
Oba pola energy i bandwidth wynoszą 0	Należy zażądać co najmniej jednego zasobu.
energy lub bandwidth poza zakresem	Żądana kwota jest poniżej minimum lub powyżej maksimum dla tego projektu.
Zduplikowane aktywne zamówienie	Aktywne zamówienie dla tej samej pary address_from + address_to już istnieje w statusie new.
order_id nie znaleziono	order_id przekazany do check lub cancel nie istnieje.
Przekroczono limit zapytań	Wysyłasz więcej niż 1 żądanie/sekundę z tego samego adresu IP. Cofnij się i spróbuj ponownie.
referral_code zbyt długi	Ciąg referral_code przekracza 64 znaki.

Obsługa błędów

1. Zawsze sprawdzaj code w treści odpowiedzi — HTTP 200 nie gwarantuje sukcesu.
2. Rejestruj request_id razem z każdym błędem do debugowania.
3. Dla HTTP 429, wdróż wykładnicze wycofanie przed ponowieniem próby.
4. Dla duplicate active order, użyj Sprawdź zamówienie, aby pobrać istniejące zamówienie zamiast tworzyć nowe.