Appearance
Registro de Alterações
Bem-vindo ao Registro de Alterações da Plataforma Netts — um diário técnico abrangente que documenta todas as atualizações, melhorias e novos recursos implementados em todo o ecossistema Netts.
Esta seção fornece informações detalhadas sobre:
- Aprimoramentos de API e novos endpoints
- Otimizações de desempenho e melhorias de infraestrutura
- Correções de bugs e atualizações de estabilidade
- Novos recursos e adições de funcionalidades
- Breaking changes e guias de migração
Todas as entradas são documentadas em um formato técnico profissional com detalhes de implementação, componentes afetados e informações de versão.
Últimas Atualizações
21 de janeiro de 2026 - Limite Máximo de Pedido de Energy Reduzido
Tipo: ⚠️ Breaking Change
Resumo: Redução da quantidade máxima de energy por pedido de 5.000.000 para 3.000.000 de unidades.
Detalhes:
- Energy máxima por pedido único: 5.000.000 → 3.000.000
- Energy mínima permanece inalterada: 61.000
- Usuários que necessitarem de mais de 3M de energy devem dividir em múltiplos pedidos
Componentes Afetados:
- API: validação do endpoint
/apiv2/order1h - Documentação: Order 1h
3 de dezembro de 2025 - Novo Endpoint de Verificação de Pedidos
Tipo: Feature
Resumo: Adicionado novo endpoint de API /apiv2/order_check para recuperar informações detalhadas sobre pedidos de energy de 1 hora.
Detalhes:
- Obtenha detalhes do pedido, incluindo custo, quantidade de energy, endereço de destino e hashes de transação
- Visualize informações de ativação se o endereço foi ativado
- Usuários principais podem ver o detalhamento da margem do subusuário (energy_markup, activation_markup, net_cost)
- Suporta validação de propriedade e controle de acesso principal-subusuário
Componentes Afetados:
- API: Novo endpoint
/apiv2/order_check - Documentação: Order Check
3 de dezembro de 2025 - Melhoria nos Códigos de Status HTTP de Idempotência e Otimização de Desempenho
Tipo: Enhancement
Resumo: Atualizados os códigos de status HTTP para respostas de idempotência para fornecer um feedback mais claro em requisições duplicadas. Também foi otimizado o processamento do pool interno para tempos de resposta inferiores a um segundo.
Detalhes:
Alterações de Códigos de Status HTTP:
- 208 Already Reported - Agora retornado quando uma requisição duplicada é recebida para um pedido já processado (anteriormente retornava 200)
- 409 Conflict - Agora retornado quando uma requisição duplicada chega enquanto a original ainda está sendo processada (anteriormente retornava 200)
- O corpo da resposta permanece inalterado - apenas o código de status HTTP é diferente
Otimização de Desempenho:
- O processamento de pedidos do pool interno agora é concluído em menos de 1 segundo (incluindo ativação de endereço)
- Tempo de resposta típico: 500-700ms para pedidos do pool interno
- O fallback de provedor externo mantém as características de desempenho existentes
Por Que Isso Importa:
- Distinção mais clara entre primeiras requisições bem-sucedidas (200) e respostas em cache/duplicadas (208/409)
- Clientes agora podem facilmente detectar respostas duplicadas verificando o código de status HTTP
- Evita confusão ao receber 200 OK para requisições que já foram processadas
- Velocidade de processamento aprimorada para uma melhor experiência do usuário
Componentes Afetados:
- API: endpoint
/apiv2/order1h - Módulo de tratamento de idempotência
- Processamento de pedidos do pool interno
19 de novembro de 2025 - Cálculo de Saldo Aprimorado na API e no Site
Tipo: ⚡ Enhancement
Resumo: Atualizada a lógica de cálculo de saldo no endpoint de API /apiv2/userinfo e na seção Carteira do site para mostrar o Total Balance TRX que inclui todas as transações pendentes.
Detalhes:
Alterações na API (/apiv2/userinfo):
- O campo
balancena resposta da API agora retorna Total Balance TRX em vez de apenas o saldo de depósito - Total Balance TRX inclui:
- Saldo da carteira de depósito
- Pagamentos pendentes (Robô e Subusuários)
- Menos saques pendentes
Alterações no Site (Seção Carteira):
- Atualizada a exibição de saldo para mostrar Total Balance TRX da API
- Lógica de frontend simplificada - removidos cálculos duplicados
- Adicionada dica de contexto informativa explicando os componentes do saldo
Importante:
- TRX de pagamentos de Robô e Subusuários são creditados no endereço de depósito 2 vezes por dia
- Antes de serem creditados, TRX de pagamentos de Robô e Subusuários não podem ser usados para compras de energy
- Para sacar TRX/USDT de pagamentos de Robô e Subusuários, ative a caixa de seleção no formulário de saque
Componentes Afetados:
- API: endpoint
/apiv2/userinfo - Site: página Carteira (Depósito e Saque)
- Backend: lógica de cálculo de saldo
19 de novembro de 2025 - Inicialização do Registro de Alterações
Tipo: 📚 Documentation
Resumo: Criação inicial do Registro de Alterações da Plataforma Netts. Isso marca o início do nosso diário técnico público, onde documentaremos todas as alterações significativas, melhorias e novos recursos.
Detalhes:
- Estabelecida a estrutura do registro de alterações e o formato de documentação
- Criada seção dedicada no site de documentação
- Implementado sistema de rastreamento de atualizações com controle de versão
Objetivo: Fornecer transparência e comunicação clara sobre a evolução da plataforma para nossos usuários, desenvolvedores e parceiros de integração.
Arquivo
Atualizações anteriores serão listadas aqui conforme ocorrerem, organizadas por data em ordem cronológica inversa.
Categorias de Atualização
As atualizações neste registro de alterações são categorizadas como:
- 🚀 Feature - Nova funcionalidade ou capacidades
- ⚡ Enhancement - Melhorias em recursos existentes
- 🐛 Fix - Correções de bugs e de erros
- 🔧 Maintenance - Atualizações de infraestrutura e desempenho
- 📚 Documentation - Adições e atualizações de documentação
- ⚠️ Breaking Change - Alterações que podem exigir atualizações de código
Para dúvidas sobre atualizações específicas ou suporte de integração, entre em contato com nossa equipe técnica ou consulte a documentação da API.