Fehlercodes

Wenn ein API-Aufruf fehlschlägt, enthält die Antwort einen code ungleich null und eine lesbare error-Meldung.

Format der Fehlerantwort

json

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

Feld	Beschreibung
`code`	Ganzzahliger Fehlercode ungleich null.
`key`	Name des Feldes, das den Fehler verursacht hat, falls zutreffend. Andernfalls leerer String.
`request_id`	Eindeutige Kennung der Anfrage. Bei Kontaktaufnahme mit dem Support angeben.
`error`	Menschenlesbare Fehlerbeschreibung.

HTTP-Status	Bedeutung
`200`	Anfrage erfolgreich (`code: 0`) oder Fehler auf Anwendungsebene (`code: non-zero`).
`429`	Rate-Limit überschritten — 1 Anfrage/Sekunde/IP für `/v1/orders*`-Endpunkte.
`422`	Nicht verarbeitbare Anfrage — Validierung fehlgeschlagen (wird auch als `code: non-zero` im Body zurückgegeben).
`500`	Interner Serverfehler — unerwarteter Fehler auf unserer Seite.

Situation	Wahrscheinliche Ursache
Ungültige `address_from` oder `address_to`	Keine gültige TRON-Adresse (muss mit `T` beginnen, 34 Zeichen).
`duration` nicht gleich `1`	Nur 1-Stunden-Vermietungen werden unterstützt.
Sowohl `energy` als auch `bandwidth` sind `0`	Mindestens eine Ressource muss angefordert werden.
`energy` oder `bandwidth` außerhalb des zulässigen Bereichs	Die angeforderte Menge liegt unter dem Minimum oder über dem Maximum für dieses Projekt.
Doppelter aktiver Auftrag	Ein aktiver Auftrag für dasselbe `address_from` + `address_to`-Paar existiert bereits im Status `new`.
`order_id` nicht gefunden	Die an `check` oder `cancel` übergebene `order_id` existiert nicht.
Rate-Limit überschritten	Du sendest mehr als 1 Anfrage/Sekunde von derselben IP. Warte und versuche es erneut.
`referral_code` zu lang	Der `referral_code`-String überschreitet 64 Zeichen.

Prüfe immer code im Antwort-Body — HTTP 200 garantiert keinen Erfolg.
Protokolliere request_id zusammen mit jedem Fehler zur Fehlersuche.
Implementiere bei HTTP 429 einen exponentiellen Backoff vor dem erneuten Versuch.
Bei duplicate active order verwende Auftrag prüfen, um den bestehenden Auftrag abzurufen, anstatt einen neuen zu erstellen.