Расчет стоимости энергии
Этот эндпоинт рассчитывает стоимость покупки энергии без создания транзакции.
POST /v1/calculate
Запрос
Параметры запроса
Поле | Тип | Обязательный | Описание |
---|---|---|---|
address | string | Да | TRON-адрес кошелька (34 символа) |
energy | integer | Да | Количество энергии для покупки (минимум 32000) |
duration | integer | Да | Длительность в часах (1 час или 24 часа) |
bash
#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{
"address": "TRX_ADDRESS",
"energy": 32000,
"duration": 1
}'
# Расчет подписи
SIGNATURE=$(echo -n "${REQUEST_BODY}${API_SECRET}" | sha256sum | cut -d' ' -f1)
# Выполнение 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}"
javascript
const crypto = require('crypto');
const axios = require('axios');
const apiToken = 'your_api_token';
const apiSecret = 'your_api_secret';
const requestBody = JSON.stringify({
address: 'TRX_ADDRESS',
energy: 32000,
duration: 1
});
// Расчет подписи
const signature = crypto
.createHash('sha256')
.update(requestBody + apiSecret)
.digest('hex');
// Выполнение 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 = 'your_api_token';
$apiSecret = 'your_api_secret';
$requestBody = json_encode([
'address' => 'TRX_ADDRESS',
'energy' => 32000,
'duration' => 1
]);
// Расчет подписи
$signature = hash('sha256', $requestBody . $apiSecret);
// Выполнение 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 = 'your_api_token'
api_secret = 'your_api_secret'
request_body = json.dumps({
'address': 'TRX_ADDRESS',
'energy': 32000,
'duration': 1
})
# Расчет подписи
signature = hashlib.sha256((request_body + api_secret).encode()).hexdigest()
# Выполнение 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())
Ответ
Ответ содержит подробную информацию о расчете стоимости покупки энергии.
Поля ответа
Поле | Тип | Описание |
---|---|---|
code | integer | Код ответа (0 = успех) |
result | object | Данные ответа |
result.address | string | TRON-адрес, указанный в запросе |
result.energy | integer | Количество энергии, указанное в запросе |
result.duration | integer | Длительность в часах, указанная в запросе |
result.price | float | Общая цена за покупку энергии |
result.activation_fee | float | Цена за активацию адреса (если требуется) |
result.total | float | Итоговая цена, включая активацию, если требуется |
Пример ответа
json
{
"code": 0,
"result": {
"address": "TRX_ADDRESS",
"energy": 32000,
"duration": 1,
"price": 1.67,
"activation_fee": 0,
"total": 1.67
}
}
Пример ответа (Адрес не активирован)
json
{
"code": 0,
"result": {
"address": "TRX_ADDRESS",
"energy": 32000,
"duration": 1,
"price": 1.67,
"activation_fee": 1.4,
"total": 3.07
}
}
Возможные ошибки
Код ошибки | Описание |
---|---|
1 | Ошибка аутентификации (неверный токен или подпись) |
2 | Неверный сервис или параметры |
5 | Кошелек не найден |
10 | Неверный TRON-адрес |
11 | Неверное количество энергии |
12 | Неверная длительность |
500 | Внутренняя ошибка сервера |
Примечания
- Количество энергии должно быть не менее 32000.
- Поддерживается длительность в 1 час и 24 часа.
- Этот эндпоинт только рассчитывает стоимость без создания транзакции.
- Для создания реальной транзакции покупки энергии используйте эндпоинт Создание транзакции.