Gestione Integrazioni
Collega i tuoi sistemi a FenixTrace con le Chiavi API. Generi una chiave "ftrace_…" dalla dashboard e i tuoi strumenti — Integration Kit AgerLink, WooCommerce, PrestaShop, CRM o ERP — inviano i prodotti via API. FenixTrace carica i dati su IPFS, registra on-chain e notarizza le etichette automaticamente: nessun wallet, nessuna chiave privata, nessun gas da gestire. Qui configuri anche i ruoli di governance come il Red Flagger.
Tipi di Accesso
Chiave API di integrazione
Una chiave API "ftrace_…" generata dalla dashboard della company (sezione Chiavi API). Permette ai tuoi sistemi esterni — Integration Kit AgerLink, WooCommerce, PrestaShop, CRM o ERP — di inviare prodotti a FenixTrace. È il metodo standard per le integrazioni automatizzate: nessun wallet, nessuna chiave privata, nessun gas da gestire lato integratore.
PermessiRegistrare nuovi prodotti via POST /api/v1/products
Caricamento automatico su IPFS lato server
Notarizzazione on-chain eseguita dal server
Generabile e revocabile in qualsiasi momento dalla dashboard
Ruolo Red Flagger (governance)
Un ruolo di governance qualità assegnato dal Super Admin. Il Red Flagger accede via email e OTP e crea segnalazioni Red Flag sui prodotti; il server firma e notarizza automaticamente i report on-chain. Non ha accesso alla gestione dei prodotti della company.
PermessiCreare segnalazioni Red Flag sui prodotti
Allegare prove documentali (caricate su IPFS lato server)
Notarizzazione dei flag on-chain eseguita dal server
Accesso alla dashboard Red Flagger via email + OTP
Come Generare una Chiave API
Accedi e apri "Chiavi API"
Accedi alla dashboard FenixTrace con la tua email e il codice OTP — nessun wallet, nessuna estensione del browser. Nella dashboard della company apri la sezione "Chiavi API".
Genera una nuova chiave
Clicca "Genera chiave API", assegnale un nome (es. "WooCommerce produzione") e confermala. FenixTrace mostra la chiave nel formato ftrace_<id>_<secret> una sola volta: copiala e conservala in modo sicuro, perché il segreto non sarà più visibile.
Configura la chiave nella tua integrazione
Inserisci la chiave nel tuo sistema esterno (Integration Kit AgerLink, plugin WooCommerce/PrestaShop, CRM o ERP). Le richieste verso FenixTrace usano l'header Authorization: Bearer ftrace_… — non servono indirizzi di contratto, object ID o chiavi private.
Invia i prodotti e verifica
Invia un prodotto di prova con POST /api/v1/products. FenixTrace carica i dati su IPFS, esegue add_product on-chain e notarizza l'etichetta automaticamente lato server. Verifica nella dashboard che il prodotto compaia con stato "notarizzato": l'integrazione è attiva.
Uso con Integration Kit e plugin
Il caso d'uso principale delle Chiavi API sono le integrazioni: Integration Kit AgerLink, plugin WooCommerce e PrestaShop, CRM ed ERP. Configuri una sola variabile — la chiave ftrace_… — e i prodotti vengono inviati a POST /api/v1/products. FenixTrace si occupa di tutto il resto lato server: caricamento su IPFS, add_product on-chain e notarizzazione dell'etichetta. Non servono indirizzi di contratto, object ID, chiavi private o gas.
Domande Frequenti
Non c'è un limite fisso. Ogni company può generare tutte le chiavi necessarie — ad esempio una per ciascuna integrazione (WooCommerce, PrestaShop, CRM, Integration Kit). È buona pratica usare una chiave distinta per ogni sistema e revocare quelle non più in uso.
No. Una chiave API può solo registrare prodotti tramite POST /api/v1/products. Non può modificare le impostazioni della company, generare o revocare altre chiavi, né gestire l'abbonamento. Queste operazioni si eseguono solo dalla dashboard, dopo accesso con email e OTP.
Dalla dashboard → Chiavi API, clicca "Revoca" accanto alla chiave. La revoca è immediata: da quel momento ogni richiesta che usa quella chiave viene rifiutata. Se una chiave viene compromessa, revocala e generane una nuova.
Nessuno lato tuo. FenixTrace gestisce la blockchain interamente in background: il server firma e notarizza le operazioni on-chain. Non devi finanziare wallet, gestire token o gas — invii semplicemente i prodotti via API e FenixTrace fa il resto.
Prossimi Passi
Dopo aver generato la chiave API, puoi integrare FenixTrace nel tuo workflow. Consulta la documentazione dell'Integration Gateway per l'integrazione con CRM ed ERP.