Codici di Errore

Quando una chiamata API fallisce, la risposta contiene un code non zero e un messaggio error leggibile.

Formato della risposta di errore

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

Field	Description
code	Codice di errore intero non zero.
key	Nome del campo che ha causato l'errore, quando applicabile. Stringa vuota altrimenti.
request_id	Identificatore univoco della richiesta. Includilo quando contatti il supporto.
error	Descrizione leggibile dell'errore.

Codici di stato HTTP

HTTP Status	Meaning
200	Richiesta riuscita (code: 0) o errore a livello applicativo (code: non-zero).
429	Limite di frequenza superato — 1 richiesta/secondo/IP sugli endpoint /v1/orders*.
422	Richiesta non processabile — validazione fallita (restituito anche come code: non-zero nel corpo).
500	Errore interno del server — errore imprevisto dal nostro lato.

Casi di errore comuni

Situation	Likely cause
address_from o address_to non valido	Non è un indirizzo TRON valido (deve iniziare con T, 34 caratteri).
duration non uguale a 1	Sono supportati solo noleggi di 1 ora.
Sia energy che bandwidth sono 0	Almeno una risorsa deve essere richiesta.
energy o bandwidth fuori dai limiti	L'importo richiesto è inferiore al minimo o superiore al massimo per questo progetto.
Ordine attivo duplicato	Esiste già un ordine attivo per la stessa coppia address_from + address_to in stato new.
order_id non trovato	L'order_id passato a check o cancel non esiste.
Limite di frequenza superato	Stai inviando più di 1 richiesta/secondo dallo stesso IP. Attendi e riprova.
referral_code troppo lungo	La stringa referral_code supera i 64 caratteri.

Gestione degli errori

1. Controlla sempre code nel corpo della risposta — HTTP 200 non garantisce il successo.
2. Registra request_id insieme a qualsiasi errore per il debug.
3. Per HTTP 429, implementa un back-off esponenziale prima di riprovare.
4. Per duplicate active order, usa Controlla Ordine per recuperare l'ordine esistente invece di crearne uno nuovo.