Fehlercodes

Diese Seite bietet Informationen über die Fehlercodes, die von der TronZap API zurückgegeben werden können.

Fehler-Antwortformat

Wenn ein Fehler auftritt, gibt die API eine Antwort mit einem Fehlercode ungleich null und einer Fehlermeldung zurück:

{
    "code": 1,
    "key": "auth",
    "request_id": "99d8b507-0bca-4d5a-9542-cc2a2f2e3639",
    "error": "Incorrect token or signature"
}

Fehlercode-Liste

Code	Key	Beschreibung	Lösung
0	—	Erfolg	Kein Fehler. Die Anfrage war erfolgreich.
1	auth	Authentifizierungsfehler	Überprüfen Sie Ihren API-Token und stellen Sie sicher, dass Ihre Signatur korrekt berechnet wird.
2	invalid_service_or_params	Ungültiger Service oder Parameter	Überprüfen Sie, dass der Service-Name und die Parameter korrekt sind.
5	wallet_not_found	Wallet nicht gefunden	Überprüfen Sie die Wallet-Adresse oder kontaktieren Sie den Support, falls Sie glauben, dass dies ein Fehler ist.
6	insufficient_funds	Unzureichende Mittel	Laden Sie Ihr Konto auf oder reduzieren Sie die angeforderte Energie-Menge.
10	invalid_tron_address	Ungültige TRON-Adresse	Überprüfen Sie das TRON-Adressformat. Es sollte eine gültige 34-stellige TRON-Adresse sein.
11	invalid_energy_amount	Ungültige Energie-Menge	Stellen Sie sicher, dass die angeforderte Energie-Menge gültig ist.
12	invalid_duration	Ungültige Dauer	Überprüfen Sie, dass der Dauer-Parameter gültig ist.
20	subscription_not_found	Abonnement nicht gefunden	Überprüfen Sie, dass die Abonnement-ID oder externe ID korrekt ist.
21	cannot_stop_subscription	Abonnement kann nicht beendet werden	Überprüfen Sie die Abonnementlimits; passen Sie das Transaktionslimit an oder schließen Sie ausstehende Transaktionen ab.
24	address_not_activated	Adresse nicht aktiviert	Aktivieren Sie die Adresse zuerst durch eine Adress-Aktivierungstransaktion.
25	address_already_activated	Adresse bereits aktiviert	Die Adresse ist bereits aktiviert. Keine Aktion erforderlich.
30	aml_check_not_found	AML-Prüfung nicht gefunden	Führen Sie die AML-Prüfung erneut durch oder kontaktieren Sie den Support, um den Prüfstatus zu bestätigen.
35	service_unavailable	Dienst nicht verfügbar	Der Dienst ist vorübergehend nicht verfügbar.
500	internal_server_error	Interner Server-Fehler	Kontaktieren Sie den Support, falls dieser Fehler anhält.

Unter-Schlüssel (Sub-keys)

Einige Fehler können einen spezifischeren Unter-Schlüssel enthalten, der zusätzlichen Kontext liefert. Unter-Schlüssel verwenden Punkt-Notation (z.B. invalid_tron_address.from_address).

Basis-Schlüssel	Sub-key	Beschreibung
invalid_tron_address	invalid_tron_address.from_address	Ungültige Absenderadresse
invalid_tron_address	invalid_tron_address.to_address	Ungültige Empfängeradresse
invalid_tron_address	invalid_tron_address.contract_address	Ungültige Vertragsadresse
invalid_tron_address	invalid_tron_address.already_subscribed	Adresse hat bereits ein aktives Abonnement
invalid_service_or_params	invalid_service_or_params.network	Nicht unterstütztes Netzwerk
invalid_service_or_params	invalid_service_or_params.address	Ungültige Adresse angegeben
invalid_service_or_params	invalid_service_or_params.hash	Hash ist für Hash-Prüfungen erforderlich
invalid_service_or_params	invalid_service_or_params.direction	Ungültiger Richtungswert
invalid_service_or_params	invalid_service_or_params.page	Ungültige Seite
invalid_service_or_params	invalid_service_or_params.per_page	Ungültiger per_page-Wert
invalid_service_or_params	invalid_service_or_params.status	Ungültiger Status
invalid_service_or_params	invalid_service_or_params.id	Ungültige id / Entweder id oder external_id ist erforderlich
invalid_service_or_params	invalid_service_or_params.external_id	Ungültige external_id
invalid_service_or_params	invalid_service_or_params.address_owner	Adresse gehört einem anderen Benutzer
invalid_service_or_params	invalid_service_or_params.internal_credit	Internes Guthaben nicht erlaubt
invalid_service_or_params	invalid_service_or_params.amount	Betrag außerhalb des gültigen Bereichs
invalid_service_or_params	invalid_service_or_params.exchange_finalized	Austausch abgeschlossen
invalid_service_or_params	invalid_service_or_params.exchange_state	Austausch in ungültigem Zustand
invalid_energy_amount	invalid_energy_amount.energy_amount	Ungültige Energie-Menge
invalid_energy_amount	invalid_energy_amount.bandwidth_amount	Ungültige Bandbreiten-Menge
invalid_duration	invalid_duration.duration	Dauer muss gleich 1 sein (1 Stunde)
address_not_activated	address_not_activated.subscription	Adresse muss vor dem Kauf eines Abonnements aktiviert werden
subscription_not_found	subscription_not_found.transaction	Transaktion nicht gefunden

Fehlerbehandlung

Beim Verwenden der API sollten Sie Fehlerbehandlungslogik für alle möglichen Fehlercodes implementieren. Hier sind einige Empfehlungen:

Authentifizierungsfehler (Code 1)

Authentifizierungsfehler weisen auf Probleme mit Ihren API-Anmeldedaten oder der Signaturberechnung hin. Sie sollten:

• Überprüfen, dass Ihr API-Token korrekt ist
• Ihre Signaturberechnungslogik überprüfen
• Sicherstellen, dass Ihr API-Geheimnis nicht im clientseitigen Code preisgegeben wird

Ressourcenfehler (Codes 5, 6, 10, 20)

Ressourcenfehler weisen auf Probleme mit den bereitgestellten Ressourcen hin. Sie sollten:

• TRON-Adressen vor dem Senden an die API validieren
• Kontostand vor Transaktionen überprüfen
• Transaktions-IDs beim Statuscheck überprüfen

Geschäftslogikfehler (Codes 24, 25)

Geschäftslogikfehler weisen auf Probleme mit dem angeforderten Vorgang hin. Sie sollten:

• Adress-Aktivierungscheck vor Energie-Kauf implementieren
• Adress-Aktivierung überspringen, falls bereits aktiviert