TR.ENERGY için API Entegrasyonu

API anahtarı nedir ve Tr.energy'nin buna neden ihtiyacı var?

API anahtarı, Tr.energy API hizmetinin güvenliğini sağlamak ve verilerinize yetkisiz erişimi önlemek için kullanılan özel bir kimlik doğrulama mekanizmasıdır. Bu, sistemin API'ye erişirken meşruiyetlerini doğrulamak için her kullanıcıya oluşturduğu ve atadığı benzersiz bir dizedir. Kullanıcıların kimliklerini doğrulamak için isteklerinin başlığına bir API anahtarı eklemeleri gerekmektedir. Bu, olası kötü niyetli saldırıları ve suistimalleri önleyerek sistemimizin bütünlüğünü ve işlevselliğini korur.

API anahtarı nasıl alınır?

1. Sisteme giriş yapın ve API bölümündeki Ayarlar sayfasına gidin.

2. Anahtarı almak için "Oluştur" butonuna tıklayın. Ardından, sistem sizin için benzersiz bir API anahtarı oluşturacaktır.

3. Tr.energy API servisini çağırırken kimliğinizi doğrulamak için oluşturulan API anahtarını uygulamanıza kopyalayın.

4. API'mizle nasıl etkileşim kuracağınızı öğrenmek için bağlantıyı takip edin.

Notlar

1. İstenmeyen kullanımını önlemek için API anahtarınızı kimseyle paylaşmayın.

2. API anahtarınız kaybolursa veya sızdırılırsa, lütfen müşteri destek ekibimizle iletişime geçin - [email protected]

3. Daha fazla yardıma ihtiyacınız olursa veya herhangi bir sorunla karşılaşırsanız, lütfen bize e-posta gönderin - [email protected]

1. YETKİLENDİRME

Başlıkta API anahtarı (Bearer Token) kullanıldığında otomatik olarak gerçekleşir.

2. BAKİYE KONTROLÜ

GET 1.1 yöntemini kullanın. Göster

3. DOLDUR

GET 1.2 yöntemini kullanın. Tamamlayın

4. SİPARİŞİN OLUŞTURULMASI VE AKTİF HALE GETİRİLMESİ

POST 2.0 Oluştur ve Etkinleştir yöntemini kullanın

Enerji göndermeden önce, sistemimiz adresin TRON ağında etkin olup olmadığını otomatik olarak kontrol edecektir. Etkin değilse, adresi etkinleştirecek ve bu hizmetin ücretini kullanıcının bakiyesinden düşecektir. Ardından enerji adrese gönderilecektir.

"webhook_url" parametresi ayarlandığında, sipariş tamamlandıktan sonra sunucu bir POST isteği gönderecektir:
{
"durum": doğru,
"adres": tüketici_cüzdanı_adresiniz
}

5. ENERJİ TÜKETİCİLERİ LİSTESİNİN GÖRÜNTÜLENMESİ

(Bunlar enerjinin devredildiği cüzdanlardır.)

1 adresi görüntülemek için GET 2.3 yöntemini kullanın. Göster

Tüm adresleri görüntülemek için GET 2.1 yöntemini kullanın. Dizin

6. ENERJİ TÜKETİCİLERİNİN VERİLERİNİN GÜNCELLENMESİ

(Tüketici adını, enerji miktarını, enerji kiralama süresini ve otomatik yenileme durumunu değiştirebilirsiniz)

PATCH 2.6. Güncelleme yöntemini kullanın

7. DÜZENİN OLUŞTURULMASI VE AKTİF HALE GETİRİLMESİ (sıralı olarak)

POST 2.2 Oluştur yöntemini kullanın, ardından POST 2.4 Siparişi etkinleştirin

8. ENERJİ DÜZENİNİ DEVRE DIŞI BIRAKMA

POST 2.5 yöntemini kullanın. Devre dışı bırakın

9. ENERJİ TÜKETİCİSİNİ ORTADAN KALDIRMAK

DELETE 2.8 yöntemini kullanın. Yok edin

TR.ENERGY ile transit cüzdanların çalışması nasıl uygulanır?

Sisteminizde yeni bir cüzdan oluşturun, oradaki müşterilerden kripto para kabul edin ve işlemin "saflığını" kontrol edin. Sonuçtan memnunsanız, bu fonları ana cüzdanınıza gönderebilirsiniz. Tek bir işlem için 64k-130k enerji yeterlidir (TRON ağının yüküne bağlı olarak). Bunu yapmak için bu cüzdanda bir enerji siparişi oluşturmanız gerekir.

POST 2.2 metodunu kullanın. Aşağıdaki parametrelerle bir istek oluşturun:

{
  "payment_period": 15,
  "address": "TY3dRk4eQ75dCrW7tUcCzggU9rnz4V111",
  "auto_renewal": 0,
  "resource_amount": 65150,
  "name": "transit-TY3dR"
}

Talebinize yanıt alın

{
  "data": {
    "id": 2416165,
    "name": "transit-TY3dR",
    "address": "TY3dRk4eQ75dCrW7tUcCzggU9rnz4V111",
    "resource": "ENERGY",
    "resource_amount": 65150,
    "estimated_cost_trx": 3.48,
    "desired_resource_amount": 65150,
    "creation_type": 2,
    "recharge_type": null,
    "payment_period": 15,
    "auto_renewal": false,
    "is_active": false,
    "activation_queue": false,
    "order": null,
    "threshold": null,
    "webhook_url": null,
    "activated_at": null,
    "deactivated_at": null,
    "created_at": "29-09-2025 08:44:18",
    "updated_at": "29-09-2025 08:44:18"
  },
  "status": true
}

Daha önce POST 2.2 Create metodunu kullandıysanız siparişi ayrıca aktifleştirin.

POST 2.4 isteğini oluşturun. Aşağıdaki parametrelerle etkinleştirin:

core.tr.energy/api/consumers/{Tüketicinizin Kimliği}/activate

Bakiye yeterli ise, seçilen kaynağı almak için birkaç saniye bekleyin ve transfer işlemine devam edebilirsiniz.