Biblioteki SDK

TronZap zapewnia oficjalne biblioteki SDK dla wielu języków programowania, aby pomóc w łatwej integracji z naszym API. Te SDK-i obsługują uwierzytelnianie, wywołania API i obsługę błędów, pozwalając skupić się na budowaniu aplikacji.

Dostępne SDK

Obecnie oferujemy SDK dla następujących języków:

PHP SDK

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

Zobacz PHP SDK na GitHub

Node.js SDK

To SDK jest zaprojektowane do pracy na wielu platformach JavaScript/TypeScript:

• Node.js: v16.0.0 lub wyższy
• Bun: v1.0.0 lub wyższy
• Deno: v1.0.0 lub wyższy

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

Zobacz Node.js SDK na GitHub

Python SDK

pip install tronzap-sdk

Zobacz Python SDK na GitHub

Podstawowe użycie

Wszystkie SDK zapewniają podobny interfejs do interakcji z API TronZap. Oto kilka podstawowych przykładów:

PHP

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

// Inicjalizacja klienta
$apiToken = 'twoj_token_api';
$apiSecret = 'twoj_sekret_api';
$client = new Client($apiToken, $apiSecret);

try {
    // Pobierz dostępne usługi
    $services = $client->getServices();

    // Utwórz transakcję energii
    $transaction = $client->createEnergyTransaction(
        'ADRES_TRX', // Adres portfela TRON
        65000,       // Ilość energii
        1,           // Czas trwania (godziny)
        'moj-tx-id', // Zewnętrzne ID (opcjonalne)
        false        // Nie aktywuj adresu (opcjonalne)
    );

    // Sprawdź status transakcji
    $status = $client->checkTransaction($transaction['result']['transaction_id']);

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

Node.js

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

// Inicjalizacja klienta
const client = new TronZapClient({
  apiToken: 'twoj_token_api',
  apiSecret: 'twoj_sekret_api'
});

async function main() {
  try {
    // Pobierz dostępne usługi
    const services = await client.getServices();
    console.log(services);

    // Utwórz transakcję energii
    const transaction = await client.createEnergyTransaction(
      'ADRES_PORTFELA_TRON',
      65150,
      1,
      'moj-tx-id',  // Opcjonalne zewnętrzne ID
      true         // Opcjonalne: aktywuj adres jeśli potrzeba
    );
    console.log(transaction);

    // Sprawdź status transakcji
    const status = await client.checkTransaction(transaction.result.transaction_id);
    console.log(status);

  } catch (error) {
    if (error instanceof TronZapError) {
      console.error(`Błąd API TronZap: ${error.message} (Kod: ${error.code})`);
    } else {
      // Sprawdź typ błędu przed dostępem do jego właściwości
      if (error instanceof Error) {
        console.error(`Błąd ogólny: ${error.message}`);
      } else {
        console.error('Wystąpił nieznany błąd:', error);
      }
    }
  }
}

main();

Python

from tronzap_sdk import TronZapClient, TronZapError

# Inicjalizacja klienta
api_token = 'twoj_token_api'
api_secret = 'twoj_sekret_api'
client = TronZapClient(api_token, api_secret)

try:
    # Pobierz dostępne usługi
    services = client.get_services()

    # Utwórz transakcję energii
    transaction = client.create_energy_transaction(
        address='ADRES_TRX',    # Adres portfela TRON
        energy_amount=65000,    # Ilość energii
        duration=1,             # Czas trwania (godziny)
        external_id='moj-tx-id', # Zewnętrzne ID (opcjonalne)
        activate_address=False  # Nie aktywuj adresu (opcjonalne)
    )

    # Sprawdź status transakcji
    status = client.check_transaction(transaction['result']['transaction_id'])

except TronZapError as e:
    print(f"Błąd: {e.message} (Kod: {e.code})")

Funkcje

Wszystkie nasze SDK zapewniają następujące funkcje:

• Uwierzytelnianie: Automatyczne generowanie podpisów API dla bezpiecznych żądań
• Informacje o usługach: Pobieranie dostępnych usług i cen
• Transakcje energii: Tworzenie transakcji do zakupu energii
• Aktywacja adresu: Tworzenie transakcji do aktywacji adresu
• Status transakcji: Sprawdzanie statusu transakcji
• Zarządzanie kontem: Pobieranie salda konta i informacji o użyciu

Dokumentacja

Pełną dokumentację każdego SDK znajdziesz w odpowiednich repozytoriach GitHub.