SDK Библиотеки

TronZap предоставляет официальные SDK библиотеки для нескольких языков программирования, чтобы помочь вам легко интегрироваться с нашим API. Эти SDK обрабатывают аутентификацию, API-вызовы и обработку ошибок, позволяя вам сосредоточиться на разработке вашего приложения.

Доступные SDK

В настоящее время мы предлагаем SDK для следующих языков:

PHP SDK

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

Смотреть PHP SDK на GitHub

Node.js SDK

Этот SDK разработан для работы на нескольких платформах JavaScript/TypeScript:

• Node.js: версии 16.0.0 и выше
• Bun: версии 1.0.0 и выше
• Deno: версии 1.0.0 и выше

npm install tronzap-sdk
# или
yarn add tronzap-sdk
# или
pnpm add tronzap-sdk

Смотреть Node.js SDK на GitHub

Python SDK

pip install tronzap-sdk

Смотреть Python SDK на GitHub

Базовое использование

Все SDK предоставляют схожий интерфейс для взаимодействия с API TronZap. Вот несколько базовых примеров:

PHP

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

// Инициализация клиента
$apiToken = 'ваш_api_token';
$apiSecret = 'ваш_api_secret';
$client = new Client($apiToken, $apiSecret);

try {
    // Получение доступных сервисов
    $services = $client->getServices();

    // Создание транзакции энергии
    $transaction = $client->createEnergyTransaction(
        'TRX_АДРЕС',   // TRON адрес кошелька
        32000,         // Количество энергии
        1,             // Длительность (часы)
        'my-tx-id',    // Внешний ID (опционально)
        false          // Не активировать адрес (опционально)
    );

    // Проверка статуса транзакции
    $status = $client->checkTransaction($transaction['result']['transaction_id']);

} catch (TronZapException $e) {
    echo "Ошибка: " . $e->getMessage() . " (Код: " . $e->getCode() . ")\n";
}

Node.js

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

// Инициализация клиента
const client = new TronZapClient({
  apiToken: 'your_api_token',
  apiSecret: 'your_api_secret'
});

async function main() {
  try {
    // Получение доступных сервисов
    const services = await client.getServices();
    console.log(services);

    // Создание транзакции энергии
    const transaction = await client.createEnergyTransaction(
      'TRX_АДРЕС',   // TRON адрес кошелька
      32000,         // Количество энергии
      1,             // Длительность (часы)
      'my-tx-id',    // Внешний ID (опционально)
      true          // Не активировать адрес (опционально)
    );
    console.log(transaction);

    // Проверка статуса транзакции
    const status = await client.checkTransaction(transaction.result.transaction_id);
    console.log(status);

  } catch (error) {
    if (error instanceof TronZapError) {
      console.error(`TronZap API Error: ${error.message} (Code: ${error.code})`);
    } else {
      if (error instanceof Error) {
        console.error(`General error: ${error.message}`);
      } else {
        console.error('An unknown error occurred:', error);
      }
    }
  }
}

main();

Python

from tronzap_sdk import TronZapClient, TronZapError

# Инициализация клиента
api_token = 'ваш_api_token'
api_secret = 'ваш_api_secret'
client = TronZapClient(api_token, api_secret)

try:
    # Получение доступных сервисов
    services = client.get_services()

    # Создание транзакции энергии
    transaction = client.create_energy_transaction(
        address='TRX_АДРЕС',      # TRON адрес кошелька
        energy_amount=32000,      # Количество энергии
        duration=1,               # Длительность (часы)
        external_id='my-tx-id',   # Внешний ID (опционально)
        activate_address=False    # Не активировать адрес (опционально)
    )

    # Проверка статуса транзакции
    status = client.check_transaction(transaction['result']['transaction_id'])

except TronZapError as e:
    print(f"Ошибка: {e.message} (Код: {e.code})")

Возможности

Все наши SDK предоставляют следующие возможности:

• Аутентификация: Автоматическая генерация API подписей для безопасных запросов
• Информация о сервисах: Получение доступных сервисов и цен
• Транзакции энергии: Создание транзакций для покупки энергии
• Активация адреса: Создание транзакций для активации адреса
• Статус транзакции: Проверка статуса ваших транзакций
• Управление аккаунтом: Получение информации о балансе и использовании аккаунта

Документация

Для полной документации по каждому SDK, пожалуйста, обратитесь к соответствующим репозиториям на GitHub.