GET /apiv2/order_check

Recupere informações detalhadas sobre um pedido específico de energy de 1 hora, incluindo detalhamento de custos, detalhes de ativação e informações de margem de subusuário.

URL do endpoint

GET https://netts.io/apiv2/order_check

Cabeçalhos da requisição

Header	Required	Description
X-API-KEY	Sim	Sua chave de API do painel Netts

Parâmetros de consulta

Parameter	Type	Required	Description
order_id	string	Sim	ID do pedido no formato 1H{hash} (ex.: 1Ha1b2c3d4e5)

Exemplos

cURL

curl -X GET "https://netts.io/apiv2/order_check?order_id=1Ha1b2c3d4e5" \
  -H "X-API-KEY: your_api_key"

Python

import requests

url = "https://netts.io/apiv2/order_check"
headers = {
    "X-API-KEY": "your_api_key"
}
params = {
    "order_id": "1Ha1b2c3d4e5"
}

response = requests.get(url, headers=headers, params=params)
data = response.json()

if data.get("success"):
    order = data.get("order", {})
    print(f"Order ID: {order.get('id')}")
    print(f"Total Cost: {order.get('cost')} TRX")
    print(f"Energy: {order.get('energy')}")
    print(f"Rate: {order.get('rate_sun')} sun/energy")
    print(f"Target Address: {order.get('target_address')}")

    # Check if activation was performed
    activation = data.get("activation")
    if activation:
        print(f"Activation Cost: {activation.get('cost')} TRX")
        print(f"Activation Hash: {activation.get('tx_hash')}")
else:
    print(f"Error: {data.get('msg')}")

JavaScript (Node.js)

const axios = require('axios');

const url = 'https://netts.io/apiv2/order_check';
const headers = {
    'X-API-KEY': 'your_api_key'
};
const params = {
    order_id: '1Ha1b2c3d4e5'
};

axios.get(url, { headers, params })
    .then(response => {
        const data = response.data;
        if (data.success) {
            console.log('Order:', data.order);
            console.log('Activation:', data.activation);
        } else {
            console.log('Error:', data.msg);
        }
    })
    .catch(error => console.error('Request failed:', error));

Resposta

Resposta de Sucesso (200 OK)

{
    "success": true,
    "code": 10000,
    "order": {
        "id": "1Ha1b2c3d4e5",
        "cost": 2.535,
        "target_address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "energy": 65000,
        "duration": "1 hour",
        "tx_hashes": ["a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef12345678"],
        "timestamp": "2025-12-03T15:21:34.182127",
        "rate_sun": 39.0,
        "comments": null
    },
    "activation": null,
    "subuser_payout": null
}

Resposta de Sucesso com Ativação (200 OK)

Quando o endereço de destino exigiu ativação:

{
    "success": true,
    "code": 10000,
    "order": {
        "id": "1Ha1b2c3d4e5",
        "cost": 3.635,
        "target_address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "energy": 65000,
        "duration": "1 hour",
        "tx_hashes": ["a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef12345678"],
        "timestamp": "2025-12-03T15:21:34.182127",
        "rate_sun": 39.0,
        "comments": "Includes activation: 1.1 TRX"
    },
    "activation": {
        "cost": 1.1,
        "tx_hash": "b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456789a"
    },
    "subuser_payout": null
}

Resposta de Sucesso com Pagamento de Subusuário (200 OK)

Para usuários principais visualizando pedidos de subusuários:

{
    "success": true,
    "code": 10000,
    "order": {
        "id": "1Ha1b2c3d4e5",
        "cost": 3.93,
        "target_address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "energy": 65000,
        "duration": "1 hour",
        "tx_hashes": ["c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456789abc"],
        "timestamp": "2025-12-03T16:55:16.525118",
        "rate_sun": 60.5,
        "comments": "Includes activation: 1.1 TRX"
    },
    "activation": {
        "cost": 1.1,
        "tx_hash": "b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456789a"
    },
    "subuser_payout": {
        "parent_id": 12,
        "gross_cost": 3.93,
        "energy_markup": 0.195,
        "activation_markup": 0.1,
        "total_markup": 0.295,
        "net_cost": 3.635,
        "subuser_rate_sun": 43.5,
        "parent_rate_sun": 39.0
    }
}

Campos de Resposta

Resposta Principal

Field	Type	Description
success	boolean	true se a requisição foi bem-sucedida
code	integer	10000 para requisições bem-sucedidas
order	object	Detalhes do pedido
activation	object | null	Detalhes da ativação (se o endereço foi ativado)
subuser_payout	object | null	Detalhes da margem do subusuário (apenas para usuários principais)

Objeto Order

Field	Type	Description
id	string	ID do pedido no formato 1H{hash}
cost	number	Custo total pago pelo usuário (TRX)
target_address	string	Endereço que recebeu energy
energy	integer	Quantidade de energy delegada
duration	string	Duração da delegação (sempre "1 hour")
tx_hashes	array	Lista de hashes de transação da delegação
timestamp	string	Horário de criação do pedido (formato ISO 8601)
rate_sun	number	Taxa de energy em sun por unidade de energy
comments	string | null	Informações adicionais (ex.: aviso de ativação)

Objeto Activation

Field	Type	Description
cost	number	Custo de ativação (TRX)
tx_hash	string	Hash da transação de ativação

Objeto Subuser Payout

Apenas Usuários Principais

O campo subuser_payout é incluído apenas para usuários principais visualizando os pedidos de seus subusuários. Subusuários (usuários simulados) não verão este campo.

Field	Type	Description
parent_id	integer	ID do usuário principal
gross_cost	number	Custo total pago pelo subusuário (TRX)
energy_markup	number	Valor da margem de energy (TRX)
activation_markup	number	Valor da margem de ativação (TRX)
total_markup	number	Margem total (energy + ativação)
net_cost	number	Custo menos a margem (custo real do usuário principal)
subuser_rate_sun	number	Taxa paga pelo subusuário (sun/energy)
parent_rate_sun	number	Taxa real sem margem (sun/energy)

Respostas de erro

ID de Pedido Ausente (400)

{
    "success": false,
    "code": -2,
    "msg": "order_id parameter required"
}

Erro de Autenticação (401)

{
    "success": false,
    "code": -1,
    "msg": "API key not provided"
}

{
    "success": false,
    "code": -1,
    "msg": "Invalid API key or IP not in whitelist"
}

Acesso Negado (403)

Ao tentar visualizar um pedido pertencente a outro usuário:

{
    "success": false,
    "code": -4,
    "msg": "Order does not belong to this user"
}

Pedido Não Encontrado (404)

{
    "success": false,
    "code": -3,
    "msg": "Order not found"
}

Erro Interno do Servidor (500)

{
    "success": false,
    "msg": "Internal server error"
}

Referência de Códigos de Erro

Code	Description	HTTP Status
10000	Sucesso	200
-1	Falha na autenticação	401
-2	Parâmetro order_id ausente	400
-3	Pedido não encontrado	404
-4	Acesso negado (não é o seu pedido)	403

Limites de taxa

Os seguintes limites de taxa se aplicam a este endpoint (por endereço IP):

Period	Limit	Description
1 segundo	50 requisições	Máximo de 50 requisições por segundo

Headers de Limite de Taxa

RateLimit-Limit: 50
RateLimit-Remaining: 49
RateLimit-Reset: 1
X-RateLimit-Limit-Second: 50
X-RateLimit-Remaining-Second: 49

Limite de Taxa Excedido (429)

{
    "message": "API rate limit exceeded"
}

Controle de Acesso

Propriedade do Pedido

Os usuários só podem visualizar seus próprios pedidos. A API verifica a propriedade com base em:

• Usuários do Google: Corresponde o google_user_id do pedido com o ID do Google do usuário
• Usuários do Telegram: Corresponde o tg_user_id do pedido com o ID do Telegram do usuário

Acesso Principal-Subusuário

Usuários principais podem visualizar pedidos criados por seus subusuários. Neste caso:

• O campo subuser_payout é incluído na resposta
• O usuário principal pode ver o detalhamento da margem e seu custo real

Acesso do Subusuário (Simulado)

Subusuários visualizando seus próprios pedidos verão:

• Seu custo real (incluindo margem) em order.cost
• Sua taxa (incluindo margem) em order.rate_sun
• O campo subuser_payout não é incluído

Casos de Uso

1. Verificar a Conclusão do Pedido

Após fazer um pedido com /apiv2/order1h, use este endpoint para verificar:

• O pedido foi processado com sucesso
• A energy foi delegada para o endereço correto
• O valor correto foi cobrado

2. Obter Hash da Transação

Recupere o hash da transação de delegação para verificação na blockchain:

response = requests.get(
    "https://netts.io/apiv2/order_check",
    headers={"X-API-KEY": "your_api_key"},
    params={"order_id": "1Ha1b2c3d4e5"}
)

data = response.json()
if data["success"]:
    tx_hashes = data["order"]["tx_hashes"]
    if tx_hashes:
        print(f"Verify on Tronscan: https://tronscan.org/#/transaction/{tx_hashes[0]}")

3. Acompanhar Custos de Subusuários (Usuários Principais)

Usuários principais podem monitorar os pedidos e os ganhos de margem de seus subusuários:

response = requests.get(
    "https://netts.io/apiv2/order_check",
    headers={"X-API-KEY": "parent_api_key"},
    params={"order_id": "1Ha1b2c3d4e5"}
)

data = response.json()
if data["success"] and data.get("subuser_payout"):
    payout = data["subuser_payout"]
    print(f"Subuser paid: {payout['gross_cost']} TRX")
    print(f"Your markup: {payout['total_markup']} TRX")
    print(f"Your actual cost: {payout['net_cost']} TRX")

Notas

• Os pedidos podem ser consultados imediatamente após a criação
• Os hashes de transação podem estar vazios se o provedor não os retornar
• O campo rate_sun mostra a taxa efetiva por unidade de energy em sun
• O custo de ativação é incluído no cost total quando aplicável
• O campo comments fornece contexto adicional (ex.: aviso de ativação)
• Este endpoint retorna apenas pedidos de 1 hora criados via /apiv2/order1h