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.
URL di base
Sandbox
Per sviluppare e testare senza spendere crediti usahttps://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.
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.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):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
- Email: support@syrto.ai
- Sito web: syrto.ai