Arquitetura de token universal, webhooks e ingestão personalizada

Webhooks fornecem a camada de ingestão orientada a eventos que conecta terminais de desktop, estratégias de nuvem e bots algorítmicos diretamente ao diário ILoveTrading. Este documento detalha a autenticação de token criptográfico, esquemas de carga útil e protocolos de integração de API personalizados.

1. Arquitetura de segurança e isolamento criptográfico

Para proteger as credenciais do usuário, ILoveTrading impõe autenticação de token sem estado em vez de armazenar senhas de corretores. Cada Token Universal atua como uma chave de ingestão privada com escopo definido:

Isolamento de conta: Cada perfil de conta de negociação mantém um token distinto. As execuções enviadas por meio do token da Conta A são estritamente isoladas da Conta B, evitando a avaliação e a contaminação do registro do corretor ao vivo.
Autenticação não interativa: Terminais e scripts automatizados autenticam solicitações HTTPS de saída sem cookies de sessão interativa.
Revogação instantânea: Se um token for comprometido, sua regeneração invalidará instantaneamente o token anterior, retornando imediatamente 401 Unauthorized em transmissões não autorizadas subsequentes.

Formula / Calculation
Verificação de segurança = HMAC-SHA256(carga útil, token universal)

2. Gerando e gerenciando tokens universais

Os tokens podem ser gerados e gerenciados diretamente no painel:1. Através do menu Integrações: Navegue até Integrações na barra lateral principal. Clique em Gerar Token para criar sua chave de integração primária. 2. Através das configurações de contas: Abra Configurações > Contas. Cada conta de negociação listada exibe seu Token Universal dedicado com controles de máscara e cópia da área de transferência com um clique. 3. Regeneração de token: Clicar em Regenerar atualiza a chave secreta no banco de dados imediatamente.

Warning

[!WARNING] A regeneração de um token desconecta instantaneamente qualquer MetaTrader EA, cTrader cBot ou complemento NinjaTrader ativo usando a chave anterior. Você deve atualizar a entrada do token no seu terminal para retomar a sincronização.

3. Protocolos de ingestão suportados

ILoveTrading oferece suporte a dois formatos principais de webhook:

Formato A: Sintaxe de alerta TradingView (compatível com PineConnector)

Para traders que usam alertas, indicadores ou estratégias PineScript do TradingView, envie uma carga bruta separada por vírgula:

Ponto final: POST https://ilove.trading/api/webhook
Tipo de conteúdo: text/plain ou application/json

<SEU_UNIVERSAL_TOKEN>,compre,EURUSD,risco=1,sl=1,0850,tp=1,0950

Parâmetro	Tipo	Obrigatório	Descrição
`token`	Corda	Sim	Seu token universal exclusivo.
`ação`	Corda	Sim	`comprar`, `vender`, `closelong`, `closeshort` ou `closepart`.
`risco`	Flutuador	Opcional	Porcentagem de risco por negociação (por exemplo, `1` para 1%).
`sl`	Flutuador	Opcional	Nível de preço exato para Stop Loss inicial.
`tp`	Flutuador	Opcional	Nível de preço exato para o Take Profit inicial.

Formato B: Ingestão programática de REST JSON

Para bots Python personalizados, scripts cURL ou sistemas de execução proprietários:

Ponto final: POST https://ilove.trading/api/webhooks/trade
Cabeçalhos:
- Tipo de conteúdo: application/json
- Autorização: Portador <YOUR_UNIVERSAL_TOKEN>

{
  "bilhete": "98765432",
  "símbolo": "EURUSD",
  "tipo": "COMPRAR",
  "lotes": 2,0,
  "preço_aberto": 1,08500,
  "preço_fechado": 1,09250,
  "stop_loss": 1,08100,
  "take_profit": 1,09500,
  "open_time": "2026-08-27T10:15:00Z",
  "close_time": "2026-08-27T11:45:00Z",
  "comissão": -7,00,
  "trocar": -0,80,
  "lucro": 1500,00
}

4. Melhores práticas e integridade do carimbo de data/hora

Tip

[!TIP] Carimbos de data e hora UTC ISO 8601: Ao enviar cargas JSON personalizadas, formate estritamente os carimbos de data e hora de abertura e fechamento em UTC (AAAA-MM-DDTHH:mm:ssZ). Os carimbos de data e hora sem deslocamentos de fuso horário distorcerão a análise da sessão e as métricas de distribuição por hora.

Important

[!IMPORTANT]> Idempotência e exclusividade do ticket: Garanta que cada negociação mantenha um ID de ticket exclusivo. O reenvio de um ID de ticket existente atualizará, em vez de duplicar, o registro comercial existente.

ILoveTrading Documentação