API e webhook: la stessa catena di fiducia, fuori dall'app

Un numero affidabile dentro un’app e non verificabile nel momento in cui la lascia non è davvero affidabile: sembra affidabile solo finché qualcuno lo osserva. La superficie programmatica di Rexfin e costruita su una regola: qualsiasi cosa una cifra possa dimostrare a schermo, la dimostra in modo identico una volta estratta tramite API, webhook o esportazione strutturata. Nulla viene ripulito per sembrare più pulito in uscita.

Cosa porta con se ogni numero in uscita

Ogni valore emesso dall’API o da un webhook arriva avvolto nella stessa busta: la sua valuta e la scala dell’unità, se si tratta di una cifra reale o modellata, e, in modo cruciale, un riferimento di citazione se e solo se è reale. Una proiezione modellata non viene mai emessa con una citazione allegata, perché non se la guadagna nemmeno dentro l’app. Se il token di accesso di chi chiama non è ambito al documento sorgente sottostante, la citazione semplicemente non si risolve: una risposta “riservato” fail-closed, non una versione ridotta di quella reale. Lo schema stesso rende inevitabile la distinzione tra reale e modellato: uno sviluppatore che integra il sistema non può scrivere per errore codice che tratti una previsione come se fosse una cifra depositata, perché il campo che porterebbe la prova semplicemente non c’è.

Un’API REST documentata e versionata

Il livello REST e una superficie di sola lettura, descritta con OpenAPI e versionata: bilanci, singole celle, scenari con nome, il verdetto del verificatore attuale per un modello e la differenza tra una versione e la precedente. E progettata per essere prevalentemente di lettura: nulla in questa superficie permette a chi chiama dall’esterno di scrivere una cella o un driver nel tuo modello, perché quell’autorità resta dentro l’app, dove l’audit trail traccia chi ha cambiato cosa. L’accesso passa attraverso OAuth/OIDC e token con ambito definito, e la portata effettiva di ogni token e limitata al più ristretto tra ciò per cui il token è stato concesso e ciò che i controlli di accesso della persona richiedente permettono: un token non può mai vedere più di quanto potrebbe vedere l’essere umano che lo ha emesso, e la perdita di accesso a metà sessione taglia fuori il token immediatamente, non al successivo rinnovo.

Webhook: informati, non interrogati

Invece di martellare l’API secondo una pianificazione, chi si iscrive si registra per gli eventi che contano: una chiusura di periodo, il completamento di un board pack, la pubblicazione di una versione, o il gate del verificatore che supera o fallisce un tentativo di esportazione. Ogni consegna e firmata, così chi la riceve può confermare che provenga davvero da Rexfin, ed e consegnata almeno una volta con un ID evento stabile, cosicche un duplicato sia rilevabile invece di essere elaborato due volte senza accorgersene. Un endpoint del sottoscrittore che risulta irraggiungibile viene ritentato con backoff, non martellato all’infinito, e le consegne passate restano elencate e riproducibili se serve ripescarne una. Un webhook verifier.failed, in particolare, e lo stesso segnale “questo modello non può essere considerato affidabile per l’esportazione” che l’app mostra internamente, portato fuori verso qualunque pipeline a valle debba saperlo, senza che nessuno debba controllare prima l’interfaccia.

Esportazioni strutturate che partono solo quando il modello quadra

Oltre al board pack leggibile da un essere umano, Rexfin può produrre esportazioni consumabili da macchina, iXBRL con tag secondo la stessa tassonomia usata dai bilanci, più JSON e CSV piatti, per l’acquisizione a valle da parte di un regolatore, di un sistema di deposito di una borsa o di una pipeline di consolidamento. Queste esportazioni sono soggette allo stesso gate del board pack: un modello sbilanciato e non riconciliato non può produrne una. Un’esportazione strutturata di un modello che non quadra è esattamente il fallimento che questa intera disciplina esiste per prevenire, quindi il gate si applica anche qui, non solo al documento che legge un essere umano.

A chi si rivolge

Questo si rivolge ai team che hanno già uno stack di BI, un sistema di consolidamento o una pipeline interna e vogliono che i numeri di Rexfin vi confluiscano senza che nessuno debba ridigitare un board pack in un foglio di calcolo, e a chiunque abbia bisogno che un sistema a valle sappia nel momento esatto in cui un modello quadra o fallisce la riconciliazione. Se il tuo piano di integrazione oggi prevede che qualcuno esporti un PDF e lo ridigiti, l’API sostituisce tutto questo con un contratto documentato che porta le stesse garanzie dell’app.

Per il lato rivolto agli agenti di questa stessa superficie, vedi come l’accesso MCP estende le stesse regole ai copiloti IA, oppure parti dall’hub del product tour per il quadro completo.