Skip to main content
L’API Syrto è un’offerta personalizzata, per singolo cliente. Syrto predispone un’API dedicata per un’organizzazione su richiesta, per casi d’uso specifici - non è un prodotto self-service pubblico. Questa sezione si applica solo se Syrto ha configurato un’API per la tua organizzazione. Per richiederne una, contatta il team commerciale.
L’API Syrto è un livello REST sopra il database finanziario di Syrto. Ogni organizzazione ha la propria API, adattata al suo caso d’uso: gli endpoint disponibili, il loro prezzo e la forma delle risposte sono configurati per cliente. La tua specifica OpenAPI - scaricata con la tua API key - è il riferimento autorevole per ciò che la tua API espone. Le pagine di questa sezione documentano le convenzioni condivise da ogni API Syrto (autenticazione, struttura della risposta, errori, rate limit, versionamento) e illustrano endpoint di esempio che mostrano il tipo di risorse che Syrto può predisporre.

​
URL di base

Tutti gli endpoint sono serviti su HTTPS. La tua API key determina quale API dell’organizzazione raggiungi e quali endpoint puoi chiamare - vedi Autenticazione.

​
I tuoi endpoint

Poiché gli endpoint sono configurati per cliente, non esiste un unico elenco fisso. Gli endpoint predisposti per la tua organizzazione sono descritti nella tua specifica, che puoi scaricare e visualizzare con la tua API key. Gli endpoint di esempio qui sotto mostrano il tipo di risorse che Syrto espone comunemente - la tua API può includerne alcuni, tutti o varianti su misura:

Dati finanziari

Uno snapshot finanziario di una singola azienda tramite codice fiscale.

Credit report

Un credit report completo - identità, indicatori di rischio, assetto proprietario, cariche e dati finanziari recenti.

Profilo aziendale

Un profilo che si adatta alla dimensione: peer per le grandi aziende, una vista di rischio più approfondita per le più piccole.

Report aziendale

Un report completo con bilanci pluriennali, sedi secondarie e titolari effettivi.

​
Struttura della risposta

Ogni risposta di successo è un oggetto JSON con due campi di primo livello: data e meta.
​
object
La risorsa dell’endpoint. In una risposta 200 il campo data è sempre presente e non nullo - una richiesta che non corrisponde ad alcuna azienda restituisce invece 404 not_found, mai un 200 con corpo vuoto.
​
object
Metadati sulla chiamata:
  • requestId - un id univoco della richiesta (req_ seguito da un UUID). Citalo nelle richieste di supporto.
  • endpoint - lo slug dell’endpoint che ha servito la richiesta.
  • usage - la misura d’uso registrata per la chiamata, come { quantity, unit }.

​
Header della risposta

Oltre al corpo JSON, le risposte includono alcuni header:

​
Avvio rapido

Una volta che Syrto ha predisposto la tua API e disponi di una key, chiama uno dei tuoi endpoint (il percorso esatto dipende dalla tua specifica):
Una chiamata riuscita restituisce 200 con un corpo { data, meta }. Se la key manca o non è valida ottieni 401; se nessuna azienda corrisponde, 404. Vedi Errori per l’elenco completo.

​
Supporto