Codici di Errore

Questa pagina fornisce informazioni sui codici di errore che possono essere restituiti dall'API TronZap.

Formato Risposta di Errore

Quando si verifica un errore, l'API restituirà una risposta con un codice di errore diverso da zero e un messaggio di errore:

{
    "code": 1,
    "error": "Descrizione del messaggio di errore"
}

Elenco Codici di Errore

Codice	Descrizione	Risoluzione
0	Successo	Non è un errore. La richiesta è stata completata con successo.
1	Errore di autenticazione	Controlla il tuo token API e assicurati che la tua firma sia calcolata correttamente.
2	Servizio o parametri non validi	Controlla che il nome del servizio e i parametri siano corretti.
5	Wallet non trovato	Verifica l'indirizzo del wallet o contatta il supporto se ritieni che questo sia un errore.
6	Fondi insufficienti	Aggiungi fondi al tuo account o riduci la quantità di energia che stai richiedendo.
10	Indirizzo TRON non valido	Controlla il formato dell'indirizzo TRON. Dovrebbe essere un indirizzo TRON valido di 34 caratteri.
11	Quantità di energia non valida	Assicurati che la quantità di energia richiesta sia valida.
12	Durata non valida	Controlla che il parametro durata sia valido.
20	Transazione non trovata	Verifica che l'ID transazione o l'ID esterno sia corretto.
24	Indirizzo non attivato	Attiva prima l'indirizzo effettuando una transazione di attivazione indirizzo.
25	Indirizzo già attivato	L'indirizzo è già attivato. Nessuna azione necessaria.
500	Errore interno del server	Contatta il supporto se questo errore persiste.

Gestione degli Errori

Quando utilizzi l'API, dovresti implementare una logica di gestione degli errori per tutti i possibili codici di errore. Ecco alcune raccomandazioni:

Errori di Autenticazione (Codice 1)

Gli errori di autenticazione indicano problemi con le tue credenziali API o il calcolo della firma. Dovresti:

• Verificare che il tuo token API sia corretto
• Controllare la logica di calcolo della firma
• Assicurarti che il tuo segreto API non sia esposto nel codice lato client

Errori di Risorse (Codici 5, 6, 10, 20)

Gli errori di risorse indicano problemi con le risorse fornite. Dovresti:

• Validare gli indirizzi TRON prima di inviarli all'API
• Controllare il saldo dell'account prima di effettuare transazioni
• Verificare gli ID transazione quando controlli lo stato

Errori di Logica di Business (Codici 24, 25)

Gli errori di logica di business indicano problemi con l'operazione richiesta. Dovresti:

• Implementare un controllo di attivazione indirizzo prima di tentare l'acquisto di energia
• Saltare l'attivazione indirizzo se già attivato