Architettura token universale, webhook e inserimento personalizzato

I webhook forniscono il livello di acquisizione basato sugli eventi che collega terminali desktop, strategie cloud e bot algoritmici direttamente al journal ILoveTrading. Questo documento descrive in dettaglio l'autenticazione del token crittografico, gli schemi di payload e i protocolli di integrazione API personalizzati.

---

1. Architettura di sicurezza e isolamento crittografico

Per proteggere le credenziali dell'utente, ILoveTrading applica l'autenticazione tramite token stateless anziché archiviare le password del broker. Ogni token universale funge da chiave di importazione privata con ambito:

• Isolamento del conto: Ogni profilo di conto di trading mantiene un token distinto. Le esecuzioni effettuate tramite il token dell'account A sono rigorosamente isolate dall'account B, impedendo la valutazione e la contaminazione dei record dei broker in tempo reale.
• Autenticazione non interattiva: Terminali e script automatizzati autenticano le richieste HTTPS in uscita senza cookie di sessione interattivi.
• Revoca istantanea: Se un token è compromesso, la sua rigenerazione invalida immediatamente il token precedente, restituendo immediatamente "401 Unauthorized" nelle successive trasmissioni non autorizzate.

Formula / Calculation
Verifica di sicurezza = HMAC-SHA256(carico utile, token universale)

---

2. Generazione e gestione di token universali

I token possono essere generati e gestiti direttamente dalla dashboard:1. Tramite il menu Integrazioni: Vai a Integrazioni nella barra laterale principale. Fai clic su Genera token per creare la chiave di integrazione primaria. 2. Tramite Impostazioni account: Apri Impostazioni > Account. Ogni conto di trading elencato mostra il suo token universale dedicato con controlli di mascheramento e copia degli appunti con un clic. 3. Rigenerazione token: facendo clic su Rigenera si aggiorna immediatamente la chiave segreta nel database.

---

3. Protocolli di acquisizione supportati

ILoveTrading supporta due formati webhook principali:

Formato A: sintassi degli avvisi di TradingView (compatibile con PineConnector)

Per i trader che utilizzano avvisi, indicatori o strategie PineScript di TradingView, invia un payload non elaborato separato da virgole:

• Endpoint: POST https://ilove.trading/api/webhook
• Tipo di contenuto: text/plain o application/json

"testo". <YOUR_UNIVERSAL_TOKEN>,acquista,EURUSD,rischio=1,sl=1.0850,tp=1.0950

| Parametro | Digitare | Obbligatorio | Descrizione |
|---|---|---|---|
| `gettone` | Stringa | Sì | Il tuo token universale unico. |
| `azione` | Stringa | Sì | "acquista", "vendi", "closelong", "closeshort" o "closepart". || "simbolo" | Stringa | Sì | Simbolo dello strumento (ad esempio, `EURUSD`, `NQ1!`, `BTCUSD`). |
| `rischio` | Galleggiante | Facoltativo | Percentuale di rischio per operazione (ad esempio, "1" per 1%). |
| `sl` | Galleggiante | Facoltativo | Livello di prezzo esatto per lo Stop Loss iniziale. |
| `tp` | Galleggiante | Facoltativo | Livello di prezzo esatto per il Take Profit iniziale. |

---

### Formato B: inserimento JSON REST programmatico
Per bot Python personalizzati, script cURL o sistemi di esecuzione proprietari:

* **Endpoint:** `POST https://ilove.trading/api/webhooks/trade`
* **Intestazioni:**
  * `Tipo di contenuto: application/json`
  * `Autorizzazione: Titolare <YOUR_UNIVERSAL_TOKEN>`

```json
{
  "biglietto": "98765432",
  "simbolo": "EURUSD",
  "tipo": "ACQUISTA",
  "lotti": 2.0,
  "open_price": 1.08500,
  "close_price": 1.09250,
  "stop_loss": 1.08100,
  "take_profit": 1.09500,
  "open_time": "27-08-2026T10:15:00Z",
  "close_time": "27-08-2026T11:45:00Z",
  "commissione": -7.00,
  "scambio": -0,80,
  "profitto": 1500,00
}

---

4. Migliori pratiche e integrità del timestamp

[!CONSIGLIO] Segnatempo UTC ISO 8601: quando invii payload JSON personalizzati, formatta rigorosamente i timestamp di apertura e chiusura in formato UTC (AAAA-MM-GGTHH:mm:ssZ). I timestamp con differenze di fuso orario mancanti distorceranno l'analisi della sessione e le metriche di distribuzione oraria.