Kody błędów

Ta strona zawiera informacje o kodach błędów, które mogą być zwracane przez API TronZap.

Format odpowiedzi błędu

Gdy wystąpi błąd, API zwróci odpowiedź z niezerowym kodem błędu i komunikatem błędu:

{
    "code": 1,
    "error": "Opis komunikatu błędu"
}

Lista kodów błędów

Kod	Opis	Rozwiązanie
0	Sukces	To nie jest błąd. Żądanie zakończyło się pomyślnie.
1	Błąd uwierzytelniania	Sprawdź swój token API i upewnij się, że podpis jest obliczony poprawnie.
2	Nieprawidłowa usługa lub parametry	Sprawdź, czy nazwa usługi i parametry są poprawne.
5	Portfel nie znaleziony	Zweryfikuj adres portfela lub skontaktuj się z pomocą techniczną, jeśli uważasz, że to błąd.
6	Niewystarczające środki	Doładuj konto lub zmniejsz ilość żądanej energii.
10	Nieprawidłowy adres TRON	Sprawdź format adresu TRON. Powinien to być prawidłowy 34-znakowy adres TRON.
11	Nieprawidłowa ilość energii	Upewnij się, że żądana ilość energii jest prawidłowa.
12	Nieprawidłowy czas trwania	Sprawdź, czy parametr czasu trwania jest prawidłowy.
20	Transakcja nie znaleziona	Zweryfikuj, czy ID transakcji lub zewnętrzne ID jest poprawne.
24	Adres nie aktywowany	Najpierw aktywuj adres, wykonując transakcję aktywacji adresu.
25	Adres już aktywowany	Adres jest już aktywowany. Nie trzeba podejmować działań.
500	Wewnętrzny błąd serwera	Skontaktuj się z pomocą techniczną, jeśli ten błąd będzie się powtarzać.

Obsługa błędów

Podczas korzystania z API powinieneś zaimplementować logikę obsługi błędów dla wszystkich możliwych kodów błędów. Oto kilka rekomendacji:

Błędy uwierzytelniania (Kod 1)

Błędy uwierzytelniania wskazują na problemy z danymi uwierzytelniania API lub obliczaniem podpisu. Powinieneś:

• Zweryfikować, czy token API jest poprawny
• Sprawdzić logikę obliczania podpisu
• Upewnić się, że sekret API nie jest ujawniony w kodzie po stronie klienta

Błędy zasobów (Kody 5, 6, 10, 20)

Błędy zasobów wskazują na problemy z podanymi zasobami. Powinieneś:

• Walidować adresy TRON przed wysłaniem ich do API
• Sprawdzić saldo konta przed wykonaniem transakcji
• Zweryfikować ID transakcji podczas sprawdzania statusu

Błędy logiki biznesowej (Kody 24, 25)

Błędy logiki biznesowej wskazują na problemy z żądaną operacją. Powinieneś:

• Zaimplementować sprawdzanie aktywacji adresu przed próbą zakupu energii
• Pominąć aktywację adresu, jeśli jest już aktywowany