API zur TRON-Energiemiete
Mieten Sie TRON-Energie programmatisch, statt TRX für Gebühren zu verbrauchen. So sparen Sie 70–80 % bei jeder TRC-20-Überweisung.
- Bestellung: Empfängeradresse, Energiemenge und Mietdauer angeben. Die Delegation erfolgt innerhalb von Sekunden
- Bestellabfragen: Delegationsstatus und Ablaufdatum nach Bestell-ID oder Adresse abfragen
- Preise: aktuelle Stückpreise und Preisstufen zur Kostenplanung
- Webhooks: Ereignisse für erfolgreiche Delegation und Ablauf, mit HMAC signiert
GET / POST /api/v1/energy/*
Authentifizierung
Die Energiemiet-API authentifiziert mit Ihrem Nutzer-API-Schlüssel. Fügen Sie jeder Anfrage folgende Header hinzu:
Melden Sie sich in der Konsole an, öffnen Sie Werkzeuge und Einstellungen → API-Verwaltung und erstellen sowie aktivieren Sie einen API-Schlüssel, um X-API-Key und X-Secret-Key zu erhalten.
Signierte Aufrufe kostenpflichtiger Endpunkte
Auftragserstellung, Einmalauftrag und Rückforderung sind kostenpflichtige Endpunkte. Neue API-Schlüssel verlangen dafür standardmäßig Signaturen (X-Key-ID / X-Timestamp / X-Nonce / X-Sign-Version / X-Signature); unten steht ein vollständiges Beispiel zur Auftragserstellung. Abfrage-Endpunkte akzeptieren weiterhin allein X-API-Key + X-Secret-Key. Bei deaktivierter Signaturpflicht für kostenpflichtige Vorgänge und sensible Daten akzeptieren auch kostenpflichtige Endpunkte den einfachen X-Secret-Key; dies wird nicht empfohlen.
Übersicht
USDT-Überweisungen auf TRON verbrauchen Energie. Adressen ohne eingefrorene TRX zahlen etwa 6.5-13 TRX Gas je Transaktion. Mit gemieteter Energie nutzt die Überweisung diese Energie, statt dafür TRX zu verbrennen; wie viel Sie sparen, hängt vom Mietpreis bei der Bestellung ab.
USDT-Überweisung an Adresse mit USDT-Guthaben: etwa 65.000 Energie
USDT-Überweisung an Adresse ohne bisherigen USDT-Empfang: etwa 135.000 Energie
Plattforminformationen abrufen
GET /api/v1/energy/info
Öffentliche Informationen zur Energiemiete abrufen, einschließlich verfügbarer Energie, Preisstufen und Limits.
Kontoguthaben abfragen
GET /api/v1/energy/balance
Guthaben des Kontos abfragen, zu dem dieser API-Schlüssel gehört. Energiemiete umfasst häufige kleine Zahlungen; unzureichendes Guthaben kommt regelmäßig vor. Prüfen Sie vor Sammelaufträgen und richten Sie eine Warnung bei niedrigem Guthaben ein.
Mietzeiträume auflisten (Endpunkt)
GET /api/v1/energy/periods
Gibt unterstützte Zeitraumwerte zurück. Werte außerhalb der Liste werden mit 400 abgewiesen; es wird kein Auftrag erstellt.
Preisschätzung
GET /api/v1/energy/price
Mietkosten für Zeitraum und Energiemenge schätzen. Gibt API-spezifischen Preis in TRX zurück.
Energieverbrauch schätzen
GET /api/v1/energy/estimate-energy
Benötigte Energie für eine USDT-Überweisung an eine bestimmte Adresse schätzen.
Mietauftrag erstellen
POST /api/v1/energy/order
Energiemietauftrag erstellen; Gebühr wird vom Kontoguthaben in USD abgebucht.
Antwortfelder
Bei unzureichendem Guthaben wird code: 400, message: "Insufficient account balance, please top up first" zurückgegeben
Einmaliger Energieauftrag
POST /api/v1/energy/order/onetime
Einzelauftrag nach Strategie je Transaktion erstellen; energy_amount wird vom System automatisch festgelegt.
Auftragsliste abfragen
GET /api/v1/energy/orders
Ihre Energiemietaufträge abfragen.
Einzelauftrag abfragen
GET /api/v1/energy/order/:serial
Auftragsdetails abfragen und den neuesten Status synchronisieren.
Auftrag anhand Ihrer eigenen Transaktionsnummer abfragen
GET /api/v1/energy/order/by-trade-no/:out_trade_no
Auftrag anhand Ihrer eigenen out_trade_no suchen; unsere Seriennummer ist nicht erforderlich.
⚠️ Bei einer Zeitüberschreitung liefert der Erstellungsendpunkt 504. Dann haben Sie nur out_trade_no: Unsere Seriennummer ist in der Zeitüberschreitungsantwort nicht enthalten. Genau dafür dient dieser Endpunkt; rufen Sie das endgültige Ergebnis mit derselben out_trade_no ab.
Auftrag zurücknehmen
POST /api/v1/energy/order/reclaim
Nicht abgelaufenen Energiemietauftrag vorzeitig zurücknehmen.
Callback für Auftragsergebnisse
Für Aufträge mit callback_url (einschließlich Einmalaufträgen) sendet die Plattform das Ergebnis einmal an diese URL, sobald der Auftrag erstmals als erfolgreich (status=40) oder fehlgeschlagen (status=41) feststeht. Ob dies durch Echtzeit-Statusmeldung, Abfrage, Abgleich oder Wiederherstellung eines nicht gespeicherten Auftrags bestätigt wird: Jeder Auftrag wird nur einmal übermittelt; fehlgeschlagene Zustellungen werden automatisch wiederholt. Ausnahme: Die Erstellung lieferte 504 mit unbekanntem Ergebnis (intern als Platzhalter mit Seriennummer beginnend mit LOCAL- gespeichert). Solche Aufträge werden manuell geklärt und nie automatisch übermittelt; prüfen Sie sie über Ihre eigene Auftragsnummer. Die Plattform sendet und signiert die Callbacks; das frühere Callback-Format wird nicht mehr verwendet. Bestehende Integrationen müssen Parsing und Signaturprüfung an diesen Abschnitt anpassen.
Die Anfrage ist ein POST mit Content-Type: application/json. Der Inhalt ist ein flaches JSON-Objekt, dessen Werte alle Zeichenfolgen sind (einschließlich status, energy_amount und timestamp); Preisfelder fehlen. Die Plattform folgt keinen Weiterleitungen, und jede Anfrage hat eine Zeitgrenze von 10 Sekunden.
Signatur prüfen
Der Algorithmus entspricht den Zahlungs-Callbacks: Alle Felder mit nicht leerem Wert außer sign nach Feldnamen in ASCII-Reihenfolge sortieren, als k1=v1&k2=v2&… verbinden und HMAC-SHA256 berechnen; das Ergebnis ist Hexadezimaltext in Kleinbuchstaben. Als Schlüssel dient der Secret Key des zur Auftragserstellung verwendeten API-Schlüssels; bei Zahlungs-App-Zugangsdaten das Push Secret der App (WebhookSecret, auf der App-Detailseite in der Konsole — derselbe Schlüssel wie bei Zahlungs-Callbacks). Ältere Apps ohne erzeugtes Push Secret verwenden den App Key.
Die Benachrichtigung enthält kein sign, wenn der Plattform-Support den Auftrag für Sie angelegt hat (kein zugehöriger Schlüssel) oder der verwendete API-Schlüssel bzw. die Zahlungs-App inzwischen gelöscht wurde. Bei einer Benachrichtigung ohne sign vor jeder Verarbeitung den Status über den Auftragsabfrage-Endpunkt prüfen.
Antwort und Wiederholungen
Jeder 2xx-Status gilt als zugestellt; der Antwortinhalt wird nicht geprüft. Andere Statuscodes, Zeitüberschreitungen, Verbindungsfehler oder Weiterleitungen gelten als Fehlschlag. Die Plattform wiederholt nach 30 Sekunden, 1 Minute, 2 Minuten und 5 Minuten, danach alle 10 Minuten, bis zu 10 Wiederholungen (Ende nach etwa 70 Minuten). Dabei wird exakt derselbe Inhalt einschließlich notify_id und sign erneut gesendet.
Bricht das Netzwerk nach Verarbeitung durch Ihren Server ab, bevor die Plattform 2xx erhält, wird derselbe Auftrag erneut übermittelt. Deduplizieren Sie nach notify_id oder serial und verhindern Sie Nebenwirkungen bei doppelter Verarbeitung. Die Benachrichtigung ist nicht die einzige verlässliche Quelle: Bleibt sie aus oder scheitert die Zustellung endgültig, prüfen Sie das Ergebnis über GET /api/v1/energy/order/:serial oder Ihre eigene Auftragsnummer.
Mietzeiträume
Dies sind alle aktuell unterstützten Zeiträume. Sie können sie auch über GET /api/v1/energy/periods abrufen. Andere Werte liefern 400; kein Auftrag wird erstellt.
Häufig gestellte Fragen
Wie viel spart die Energiemiet-API tatsächlich?
Eine direkte Zahlung der Gebühren mit TRX kostet für eine TRC-20-USDT-Überweisung gewöhnlich etwa 6.5-13 TRX. Energiemiete senkt diesen Betrag um 70–80 %. Bei Sammelüberweisungen wächst der Unterschied.
Wie schnell ist die Delegation, und kann ich eine andere Adresse versorgen?
Die Delegation erfolgt innerhalb von Sekunden. Die Empfängeradresse ist die im Aufruf angegebene Adresse und muss nicht zum bestellenden Konto gehören. So können Sie beliebige Geschäftsadressen in Sammelaufträgen mit Energie versorgen.
Verwandte Seiten: TRON-Energiemiete · API-Dokumentation · Krypto-Zahlungen über mehrere Blockchains
Wird geladen…