Histórico de Assinaturas

Retorna o histórico de todas as assinaturas do usuário com suporte para paginação e filtragem por status.

POST /v1/subscriptions/history

Solicitação

Todos os parâmetros são opcionais. Se os parâmetros não forem especificados, retorna a primeira página com 10 itens.

Parâmetros da Solicitação

Campo	Tipo	Obrigatório	Descrição
page	integer	Não	Número da página (padrão: 1, mínimo: 1)
per_page	integer	Não	Quantidade de itens por página (padrão: 10, máximo: 50)
status	string	Não	Filtro por status da assinatura

Bash

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

# Cálculo da assinatura
SIGNATURE=$(echo -n "${REQUEST_BODY}${API_SECRET}" | sha256sum | cut -d' ' -f1)

# Execução da solicitação API
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'
});

// Cálculo da assinatura
const signature = crypto
  .createHash('sha256')
  .update(requestBody + apiSecret)
  .digest('hex');

// Execução da solicitação API
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'
]);

// Cálculo da assinatura
$signature = hash('sha256', $requestBody . $apiSecret);

// Execução da solicitação API
$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'
})

# Cálculo da assinatura
signature = hashlib.sha256((request_body + api_secret).encode()).hexdigest()

# Execução da solicitação API
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())

Exemplo de Solicitação sem Parâmetros

Bash

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

# Cálculo da assinatura
SIGNATURE=$(echo -n "${REQUEST_BODY}${API_SECRET}" | sha256sum | cut -d' ' -f1)

# Execução da solicitação API
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}"

Resposta

A resposta contém a lista de assinaturas do usuário com informações de paginação.

Campos da Resposta

Campo	Tipo	Descrição
code	integer	Código de resposta (0 = sucesso)
request_id	string	Identificador único da requisição
result	object	Dados da resposta
result.page	integer	Página atual
result.per_page	integer	Quantidade de itens por página
result.total	integer	Número total de assinaturas
result.items	array	Lista de assinaturas
result.items[].id	string	ID da assinatura
result.items[].status	string	Status da assinatura
result.items[].subscription_id	string	ID do tipo de assinatura
result.items[].address	string	Endereço TRON
result.items[].transactions_limit	integer	Limite de transações
result.items[].transactions_used	integer	Transações utilizadas
result.items[].energy_used	integer	Energia utilizada
result.items[].total_price	float	Custo total
result.items[].started_at	string|null	Data de início (formato ISO 8601)
result.items[].renewed_at	string|null	Data de renovação (formato ISO 8601)
result.items[].stopped_at	string|null	Data de parada (formato ISO 8601)
result.items[].expire_at	string|null	Data de expiração (formato ISO 8601)
result.items[].created_at	string	Data de criação (formato ISO 8601)

Exemplo de Resposta

{
  "code": 0,
  "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
  "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"
      }
    ]
  }
}

Status Possíveis das Assinaturas

Status	Descrição
new	Nova assinatura
pending	Assinatura pendente
error	Erro na assinatura
active	Assinatura ativa
stopped	Assinatura parada
expired	Assinatura expirada

Possíveis Erros

Código de Erro	Key	Descrição
1	auth	Erro de autenticação (token ou assinatura inválidos)
2	invalid_service_or_params	Serviço ou parâmetros inválidos
500	internal_server_error	Erro interno do servidor