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,
    "key": "auth",
    "request_id": "99d8b507-0bca-4d5a-9542-cc2a2f2e3639",
    "error": "Incorrect token or signature"
}

Elenco Codici di Errore

Codice	Key	Descrizione	Risoluzione
0	—	Successo	Non è un errore. La richiesta è stata completata con successo.
1	auth	Errore di autenticazione	Controlla il tuo token API e assicurati che la tua firma sia calcolata correttamente.
2	invalid_service_or_params	Servizio o parametri non validi	Controlla che il nome del servizio e i parametri siano corretti.
5	wallet_not_found	Wallet non trovato	Verifica l'indirizzo del wallet o contatta il supporto se ritieni che questo sia un errore.
6	insufficient_funds	Fondi insufficienti	Aggiungi fondi al tuo account o riduci la quantità di energia che stai richiedendo.
10	invalid_tron_address	Indirizzo TRON non valido	Controlla il formato dell'indirizzo TRON. Dovrebbe essere un indirizzo TRON valido di 34 caratteri.
11	invalid_energy_amount	Quantità di energia non valida	Assicurati che la quantità di energia richiesta sia valida.
12	invalid_duration	Durata non valida	Controlla che il parametro durata sia valido.
50	invalid_bandwidth_amount	Quantità di bandwidth non valida	Assicurati che la quantità di bandwidth richiesta sia valida.
20	subscription_not_found	Abbonamento non trovato	Verifica che l'ID dell'abbonamento o l'ID esterno sia corretto.
21	cannot_stop_subscription	Impossibile interrompere l'abbonamento	Verifica i limiti dell'abbonamento; regola il limite di transazioni o completa le transazioni in sospeso.
24	address_not_activated	Indirizzo non attivato	Attiva prima l'indirizzo effettuando una transazione di attivazione indirizzo.
25	address_already_activated	Indirizzo già attivato	L'indirizzo è già attivato. Nessuna azione necessaria.
30	aml_check_not_found	Verifica AML non trovata	Ripeti la verifica AML o contatta il supporto per confermare lo stato della verifica.
35	service_unavailable	Servizio non disponibile	Il servizio è temporaneamente non disponibile.
500	internal_server_error	Errore interno del server	Contatta il supporto se questo errore persiste.

Sotto-chiavi (Sub-keys)

Alcuni errori possono includere una sotto-chiave più specifica che fornisce contesto aggiuntivo. Le sotto-chiavi usano la notazione con punto (ad esempio, invalid_tron_address.from_address).

Chiave Base	Sub-key	Descrizione
invalid_tron_address	invalid_tron_address.from_address	Indirizzo mittente non valido
invalid_tron_address	invalid_tron_address.to_address	Indirizzo destinatario non valido
invalid_tron_address	invalid_tron_address.contract_address	Indirizzo contratto non valido
invalid_tron_address	invalid_tron_address.already_subscribed	L'indirizzo ha già un abbonamento attivo
invalid_service_or_params	invalid_service_or_params.network	Rete non supportata
invalid_service_or_params	invalid_service_or_params.address	Indirizzo fornito non valido
invalid_service_or_params	invalid_service_or_params.hash	L'hash è richiesto per le verifiche hash
invalid_service_or_params	invalid_service_or_params.direction	Direzione mancante o non valida (obbligatoria per le verifiche hash)
invalid_service_or_params	invalid_service_or_params.page	Pagina non valida
invalid_service_or_params	invalid_service_or_params.per_page	per_page non valido
invalid_service_or_params	invalid_service_or_params.status	Stato non valido
invalid_service_or_params	invalid_service_or_params.id	id non valido / È richiesto id o external_id
invalid_service_or_params	invalid_service_or_params.external_id	external_id non valido
invalid_service_or_params	invalid_service_or_params.address_owner	L'indirizzo appartiene a un altro utente
invalid_service_or_params	invalid_service_or_params.internal_credit	Credito interno non consentito
invalid_service_or_params	invalid_service_or_params.amount	Importo fuori intervallo
invalid_service_or_params	invalid_service_or_params.exchange_finalized	Scambio finalizzato
invalid_service_or_params	invalid_service_or_params.exchange_state	Scambio in stato non valido
invalid_energy_amount	invalid_energy_amount.energy_amount	Quantità di energia non valida
invalid_energy_amount	invalid_energy_amount.bandwidth_amount	Quantità di larghezza di banda non valida
invalid_duration	invalid_duration.duration	La durata deve essere uguale a 1 (1 ora)
address_not_activated	address_not_activated.subscription	L'indirizzo deve essere attivato prima di acquistare un abbonamento
subscription_not_found	subscription_not_found.transaction	Transazione non trovata

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