Cronologia Abbonamenti

Restituisce la cronologia di tutti gli abbonamenti dell'utente con supporto per paginazione e filtri di stato.

POST /v1/subscriptions/history

Richiesta

Tutti i parametri sono opzionali. Se i parametri non vengono specificati, restituisce la prima pagina con 10 elementi.

Parametri della Richiesta

Campo	Tipo	Richiesto	Descrizione
page	integer	No	Numero pagina (predefinito: 1, minimo: 1)
per_page	integer	No	Elementi per pagina (predefinito: 10, massimo: 50)
status	string	No	Filtra per stato abbonamento

Bash

#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{
  "page": 1,
  "per_page": 10,
  "status": "active"
}'

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

# Execute API request
curl -X POST "https://api.tronzap.com/v1/subscriptions/history" \
  -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 = 'your_api_token';
const apiSecret = 'your_api_secret';
const requestBody = JSON.stringify({
  page: 1,
  per_page: 10,
  status: 'active'
});

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

// Execute API request
axios({
  method: 'post',
  url: 'https://api.tronzap.com/v1/subscriptions/history',
  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([
  'page' => 1,
  'per_page' => 10,
  'status' => 'active'
]);

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

// Execute API request
$ch = curl_init('https://api.tronzap.com/v1/subscriptions/history');
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({
  'page': 1,
  'per_page': 10,
  'status': 'active'
})

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

# Execute API request
headers = {
  'Authorization': f'Bearer {api_token}',
  'X-Signature': signature,
  'Content-Type': 'application/json'
}

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

print(response.json())

Esempio di richiesta senza parametri

Bash

#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{}'

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

# Execute API request
curl -X POST "https://api.tronzap.com/v1/subscriptions/history" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -H "X-Signature: ${SIGNATURE}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}"

Risposta

La risposta contiene un elenco degli abbonamenti dell'utente con informazioni di paginazione.

Campi della Risposta

Campo	Tipo	Descrizione
code	integer	Codice risposta (0 = successo)
result	object	Dati della risposta
result.page	integer	Pagina corrente
result.per_page	integer	Elementi per pagina
result.total	integer	Numero totale di abbonamenti
result.items	array	Elenco degli abbonamenti
result.items[].id	string	ID abbonamento
result.items[].status	string	Stato abbonamento
result.items[].subscription_id	string	ID tipo abbonamento
result.items[].address	string	Indirizzo TRON
result.items[].transactions_limit	integer	Limite transazioni
result.items[].transactions_used	integer	Transazioni utilizzate
result.items[].energy_used	integer	Energia utilizzata
result.items[].total_price	float	Costo totale
result.items[].started_at	string	Data di inizio (formato ISO 8601)
result.items[].renewed_at	string	Data di rinnovo (formato ISO 8601)
result.items[].stopped_at	string	Data di arresto (formato ISO 8601)
result.items[].expire_at	string	Data di scadenza (formato ISO 8601)
result.items[].created_at	string	Data di creazione (formato ISO 8601)

Esempio di Risposta

{
  "code": 0,
  "result": {
    "page": 1,
    "per_page": 10,
    "total": 1,
    "items": [
      {
        "id": "01k33rz57drtqgqcedyn9tvk04",
        "status": "active",
        "subscription_id": "unlimited_energy",
        "address": "TPY1Kb8cKAZQfm95gXQQs2Mh8Uygtos21D",
        "transactions_limit": 0,
        "transactions_used": 2,
        "energy_used": 131000,
        "total_price": "8.00",
        "started_at": "2025-08-20T12:58:52+00:00",
        "renewed_at": null,
        "stopped_at": null,
        "expire_at": "2025-08-21T12:58:52+00:00",
        "created_at": "2025-08-20T12:58:52+00:00"
      },
      {
        "id": "01k36gw6cbfx4r8jhvd1qyp697",
        "status": "stopped",
        "subscription_id": "energy_pay_per_use",
        "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
        "transactions_limit": 100,
        "transactions_used": 45,
        "energy_used": 2991000,
        "total_price": 184.0,
        "started_at": "2024-02-15T10:30:00Z",
        "renewed_at": null,
        "stopped_at": "2024-03-20T14:25:00Z",
        "expire_at": null,
        "created_at": "2024-02-15T10:25:00Z"
      }
    ]
  }
}

Possibili stati degli abbonamenti

Stato	Descrizione
new	Nuovo abbonamento
pending	Abbonamento in sospeso
error	Abbonamento con errore
active	Abbonamento attivo
stopped	Abbonamento fermato
expired	Abbonamento scaduto

Possibili Errori

Codice Errore	Descrizione
1	Errore di autenticazione (token o firma non validi)
2	Servizio o parametri non validi
500	Errore interno del server