SDK Kütüphaneleri

TronZap, API'mizle kolayca entegrasyon yapmanıza yardımcı olmak için birden fazla programlama dili için resmi SDK kütüphaneleri sağlar. Bu SDK'lar kimlik doğrulama, API çağrıları ve hata yönetimini halledererek uygulamanızı oluşturmaya odaklanmanızı sağlar.

Mevcut SDK'lar

Şu anda aşağıdaki diller için SDK'lar sunuyoruz:

PHP SDK

composer require tron-energy-market/tronzap-sdk-php

GitHub'da PHP SDK'sını görüntüle

Node.js SDK

Bu SDK, birden fazla JavaScript/TypeScript platformunda çalışacak şekilde tasarlanmıştır:

• Node.js: v16.0.0 veya üzeri
• Bun: v1.0.0 veya üzeri
• Deno: v1.0.0 veya üzeri

npm install tronzap-sdk
# veya
yarn add tronzap-sdk
# veya
pnpm add tronzap-sdk

GitHub'da Node.js SDK'sını görüntüle

Python SDK

pip install tronzap-sdk

GitHub'da Python SDK'sını görüntüle

Temel Kullanım

Tüm SDK'lar TronZap API'si ile etkileşim için benzer bir arayüz sağlar. İşte bazı temel örnekler:

PHP

<?php
use TronZap\Client;
use TronZap\Exception\TronZapException;

// İstemciyi başlat
$apiToken = 'your_api_token';
$apiSecret = 'your_api_secret';
$client = new Client($apiToken, $apiSecret);

try {
    // Mevcut hizmetleri al
    $services = $client->getServices();

    // Enerji işlemi oluştur
    $transaction = $client->createEnergyTransaction(
        'TRX_ADDRESS', // TRON cüzdan adresi
        65000,         // Enerji miktarı
        1,             // Süre (saat)
        'my-tx-id',    // Dış kimlik (isteğe bağlı)
        false          // Adresi etkinleştirmeyin (isteğe bağlı)
    );

    // İşlem durumunu kontrol et
    $status = $client->checkTransaction($transaction['result']['transaction_id']);

} catch (TronZapException $e) {
    echo "Hata: " . $e->getMessage() . " (Kod: " . $e->getCode() . ")\n";
}

Node.js

import { TronZapClient, TronZapError } from 'tronzap-sdk';

// İstemciyi başlat
const client = new TronZapClient({
  apiToken: 'your_api_token',
  apiSecret: 'your_api_secret'
});

async function main() {
  try {
    // Mevcut hizmetleri al
    const services = await client.getServices();
    console.log(services);

    // Enerji işlemi oluştur
    const transaction = await client.createEnergyTransaction(
      'TRON_WALLET_ADDRESS',
      65150,
      1,
      'my-tx-id',  // İsteğe bağlı dış kimlik
      true        // İsteğe bağlı: gerekirse adresi etkinleştir
    );
    console.log(transaction);

    // İşlem durumunu kontrol et
    const status = await client.checkTransaction(transaction.result.transaction_id);
    console.log(status);

  } catch (error) {
    if (error instanceof TronZapError) {
      console.error(`TronZap API Hatası: ${error.message} (Kod: ${error.code})`);
    } else {
      // Hata özelliklerine erişmeden önce hata türünü kontrol et
      if (error instanceof Error) {
        console.error(`Genel hata: ${error.message}`);
      } else {
        console.error('Bilinmeyen bir hata oluştu:', error);
      }
    }
  }
}

main();

Python

from tronzap_sdk import TronZapClient, TronZapError

# İstemciyi başlat
api_token = 'your_api_token'
api_secret = 'your_api_secret'
client = TronZapClient(api_token, api_secret)

try:
    # Mevcut hizmetleri al
    services = client.get_services()

    # Enerji işlemi oluştur
    transaction = client.create_energy_transaction(
        address='TRX_ADDRESS',  # TRON cüzdan adresi
        energy_amount=65000,    # Enerji miktarı
        duration=1,             # Süre (saat)
        external_id='my-tx-id', # Dış kimlik (isteğe bağlı)
        activate_address=False  # Adresi etkinleştirmeyin (isteğe bağlı)
    )

    # İşlem durumunu kontrol et
    status = client.check_transaction(transaction['result']['transaction_id'])

except TronZapError as e:
    print(f"Hata: {e.message} (Kod: {e.code})")

Özellikler

Tüm SDK'larımız aşağıdaki özellikleri sağlar:

• Kimlik Doğrulama: Güvenli istekler için API imzalarının otomatik oluşturulması
• Hizmet Bilgileri: Mevcut hizmetleri ve fiyatlandırmayı alma
• Enerji İşlemleri: Enerji satın alma için işlem oluşturma
• Adres Etkinleştirme: Adres etkinleştirme için işlem oluşturma
• İşlem Durumu: İşlemlerinizin durumunu kontrol etme
• Hesap Yönetimi: Hesap bakiyesi ve kullanım bilgilerini alma

Dokümantasyon

Her SDK ile ilgili kapsamlı dokümantasyon için lütfen ilgili GitHub depolarına başvurun.