TR.ENERGY için API Entegrasyonu

API anahtarı nedir ve Tr.energy neden buna ihtiyaç duyar?

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 her kullanıcıya atadığı ve API'ye erişirken meşruiyetlerini doğrulamak için kullandığı benzersiz bir dizedir. Kullanıcıların kimliklerini kanıtlamak 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ını nasıl alabilirim?

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

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

3. Tr.energy API hizmetini ç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ımları ö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. ONAY

Bu işlem, başlıkta (Bearer Token) API anahtarı kullanıldığında otomatik olarak gerçekleşir.

2. BAKİYE KONTROLÜ

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

3. TAMAMLAMA

GET 1.2 yöntemini kullanın. Para yatırın.

4. DÜZENİN OLUŞTURULMASI VE AKTİF HALE GETİRİLMESİ

POST 2.0 Oluşturma ve Etkinleştirme Yöntemini Kullanın

Enerji göndermeden önce, sistemimiz adresin TRON ağında etkin olup olmadığını otomatik olarak kontrol edecektir. Etkin değilse, etkinleştirecek ve bu hizmet için ödemeyi kullanıcının bakiyesinden düşecektir. Bundan sonra, enerji adrese gönderilecektir.

"webhook_url" parametresi ayarlandığında, sipariş tamamlandıktan sonra sunucu bir POST isteği gönderecektir:
{
"status": true,
"address": your_consumer_wallet_address
}

5. ENERJİ TÜKETİCİLERİ LİSTESİNİN GÖSTERİLMESİ

(Bunlar, enerjinin tahsis edildiği cüzdanlardır.)

1 adres görüntülemek için GET 2.3. Show yöntemini kullanın.

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

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

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

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

7. DÜZENİN OLUŞTURULMASI VE AKTİVE EDİLMESİ (sırayla)

POST 2.2 yöntemini kullanarak sipariş oluşturun, ardından POST 2.4 yöntemini kullanarak siparişi etkinleştirin.

8. BİR ENERJİ DÜZENİNİN DEVRE DIŞI BIRAKILMASI

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

9. ENERJİ TÜKETEN BİR KAYNAĞIN ORTADAN KALDIRILMASI

DELETE 2.8 yöntemini kullanın. Yok edin.

TR.ENERGY ile transit cüzdanlarının işleyişini nasıl entegre edebilirim?

Sisteminizde yeni bir cüzdan oluşturun, orada 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. 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 yöntemini kullanın 2.2. Oluşturun. Aşağıdaki parametrelerle bir istek oluşturun:

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

Talebe 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 yöntemini kullandıysanız, siparişi ayrı olarak etkinleştirin.

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

core.tr.energy/api/consumers/{ID_tüketiciniz}/activate

Bakiyeniz yeterliyse, seçtiğiniz kaynağı almak için birkaç saniye bekleyin ve transfer işlemine devam edebilirsiniz.