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:
json
{
"code": 1,
"error": "Beschreibung der Fehlermeldung"
}Fehlercode-Liste
| Code | Beschreibung | Lösung |
|---|---|---|
| 0 | Erfolg | Kein Fehler. Die Anfrage war erfolgreich. |
| 1 | Authentifizierungsfehler | Überprüfen Sie Ihren API-Token und stellen Sie sicher, dass Ihre Signatur korrekt berechnet wird. |
| 2 | Ungültiger Service oder Parameter | Überprüfen Sie, dass der Service-Name und die Parameter korrekt sind. |
| 5 | Wallet nicht gefunden | Überprüfen Sie die Wallet-Adresse oder kontaktieren Sie den Support, falls Sie glauben, dass dies ein Fehler ist. |
| 6 | Unzureichende Mittel | Laden Sie Ihr Konto auf oder reduzieren Sie die angeforderte Energie-Menge. |
| 10 | Ungültige TRON-Adresse | Überprüfen Sie das TRON-Adressformat. Es sollte eine gültige 34-stellige TRON-Adresse sein. |
| 11 | Ungültige Energie-Menge | Stellen Sie sicher, dass die angeforderte Energie-Menge gültig ist. |
| 12 | Ungültige Dauer | Überprüfen Sie, dass der Dauer-Parameter gültig ist. |
| 20 | Abonnement nicht gefunden | Überprüfen Sie, dass die Abonnement-ID oder externe ID korrekt ist. |
| 21 | Abonnement kann nicht beendet werden | Überprüfen Sie die Abonnementlimits; passen Sie das Transaktionslimit an oder schließen Sie ausstehende Transaktionen ab. |
| 24 | Adresse nicht aktiviert | Aktivieren Sie die Adresse zuerst durch eine Adress-Aktivierungstransaktion. |
| 25 | Adresse bereits aktiviert | Die Adresse ist bereits aktiviert. Keine Aktion erforderlich. |
| 30 | 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 | Dienst nicht verfügbar | Der Dienst ist vorübergehend nicht verfügbar. |
| 500 | Interner Server-Fehler | Kontaktieren Sie den Support, falls dieser Fehler anhält. |
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