Calculer le Coût des Ressources

Ce endpoint calcule le coût d'achat de ressources sans créer de transaction.

POST /v1/calculate

Requête

Paramètres de Requête

Champ	Type	Requis	Description
service	string	Oui	Type de service (energy ou activate_address)
params	object	Oui	Paramètres du service
params.address	string	Oui	Adresse du portefeuille TRON (34 caractères)
params.amount	integer	Oui*	Quantité d'énergie ou de bande passante à acheter (minimum 50000 pour energy, 1000 pour bandwidth)
params.energy_amount	integer	Non	Obsolète. Utilisez params.amount.
params.duration	integer	Oui*	Durée en heures. Seule 1 heure est prise en charge (*requis pour le service energy)
type	string	Non	Type de ressource à calculer ("energy" par défaut ou "bandwidth")

Exemples de Requête

Bash

#!/bin/bash
API_TOKEN="votre_token_api"
API_SECRET="votre_secret_api"
REQUEST_BODY='{
  "service": "energy",
  "params": {
    "address": "ADRESSE_TRX",
    "amount": 50000,
    "duration": 1
  }
}'

# Calculer la signature
SIGNATURE=$(echo -n "${REQUEST_BODY}${API_SECRET}" | sha256sum | cut -d' ' -f1)

# Faire la requête API
curl -X POST "https://api.tronzap.com/v1/calculate" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -H "X-Signature: ${SIGNATURE}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}"

Node.js

const crypto = require('crypto');
const axios = require('axios');

const apiToken = 'votre_token_api';
const apiSecret = 'votre_secret_api';
const requestBody = JSON.stringify({
  service: 'energy',
  params: {
    address: 'ADRESSE_TRX',
    amount: 50000,
    duration: 1
  }
});

// Calculer la signature
const signature = crypto
  .createHash('sha256')
  .update(requestBody + apiSecret)
  .digest('hex');

// Faire la requête API
axios({
  method: 'post',
  url: 'https://api.tronzap.com/v1/calculate',
  headers: {
    'Authorization': `Bearer ${apiToken}`,
    'X-Signature': signature,
    'Content-Type': 'application/json'
  },
  data: requestBody
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

PHP

<?php
$apiToken = 'votre_token_api';
$apiSecret = 'votre_secret_api';
$requestBody = json_encode([
  'service' => 'energy',
  'params' => [
    'address' => 'ADRESSE_TRX',
    'amount' => 50000,
    'duration' => 1
  ]
]);

// Calculer la signature
$signature = hash('sha256', $requestBody . $apiSecret);

// Faire la requête API
$ch = curl_init('https://api.tronzap.com/v1/calculate');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $requestBody);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'Authorization: Bearer ' . $apiToken,
  'X-Signature: ' . $signature,
  'Content-Type: application/json'
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Python

import hashlib
import json
import requests

api_token = 'votre_token_api'
api_secret = 'votre_secret_api'
request_body = json.dumps({
  'service': 'energy',
  'params': {
    'address': 'ADRESSE_TRX',
    'amount': 50000,
    'duration': 1
  }
})

# Calculer la signature
signature = hashlib.sha256((request_body + api_secret).encode()).hexdigest()

# Faire la requête API
headers = {
  'Authorization': f'Bearer {api_token}',
  'X-Signature': signature,
  'Content-Type': 'application/json'
}

response = requests.post(
  'https://api.tronzap.com/v1/calculate',
  headers=headers,
  data=request_body
)

print(response.json())

Réponse

La réponse fournit les informations de coût calculées pour le service demandé.

Champs de Réponse

Champ	Type	Description
code	integer	Code de réponse (0 = succès)
request_id	string	Identifiant unique de la requête
result	object	Données de réponse
result.type	string	Type de ressource ("energy" ou "bandwidth")
result.amount	integer	Quantité d'énergie ou de bande passante fournie dans la requête
result.energy	integer	Obsolète. Utilisez result.amount.
result.price	float	Prix du service
result.address_activation_fee	float	Frais d'activation d'adresse (si applicable)
result.total	float	Prix total incluant les frais supplémentaires

Exemple de Réponse

{
    "code": 0,
    "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
    "result": {
        "type": "energy",
        "amount": 65000,
        "price": 3.4,
        "address_activation_fee": 0,
        "total": 3.4
    }
}

Erreurs Possibles

Code d'Erreur	Key	Description
1	auth	Erreur d'authentification (token ou signature incorrecte)
10	invalid_tron_address	Adresse TRON invalide
11	invalid_energy_amount	Quantité d'énergie invalide
12	invalid_duration	Durée invalide
35	service_unavailable	Service non disponible
500	internal_server_error	Erreur interne du serveur