Vai al contenuto principale
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 gli endpoint standard.

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.

Sandbox

Per sviluppare e testare senza spendere crediti usa https://sandbox.api.syrto.ai. Serve la stessa API con dati sintetici e senza addebiti. Vedi Sandbox.

I tuoi endpoint

Le organizzazioni con il pacchetto standard ottengono gli endpoint standard: dati aziendali, proprietà, bilanci, ricerca e aggregati di mercato. Altri endpoint vengono predisposti su richiesta, quindi la tua specifica OpenAPI è l’elenco di riferimento per la tua key.

Endpoint standard

Cosa restituisce ogni endpoint, quanto costa e le convenzioni condivise.

Riferimento interattivo

Parametri, corpi delle richieste e schemi di risposta di ogni endpoint standard.

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