Riferimento API

La API SISTRIX per Toolbox abilita l’accesso automatico ed è adatto a macchine per la maggioranza dei dati della toolbox. Questo ti permetterà di integrare facilmente la toolbox nei tuoi processi e strumenti interni.

L’API è parte del tuo account Toolbox e non avrai bisogno di un pacchetto speciale o di opzioni extra. I dati disponibili corrispondono ai moduli prenotati della toolbox. Su questa pagina, troverai informazioni generali sulla nostra API. È possibile accedere ai dati di Toolbox attraverso il dominio, parola chiave, collegamento e metodi d’ottimizzazione. Questi metodi sono documentati su pagine separate. Similmente, c’è una pagina per i codici di ritorno dell’API e i messaggi d’errore.

Connessione a Microsoft Excel e Google Tables

Nonostante l’API SISTRIX sia stata originariamente sviluppata per l’uso di linguaggi di programmazione e scripting, essa può anche essere utilizzata in connessione a Microsoft Excel e Google Tables. Esploreremo come connettere queste due soluzioni in due articoli separati.

Autenticazione API

L’autenticazione ha luogo attraverso la trasmissione di una chiave API. Puoi richiedere la tua chiave API nella seguente pagina e sarà solitamente disponibile entro breve:

https://it.sistrix.com/account/api

La chiave API deve essere trasmessa attraverso il parametro “api_key” con ogni richiesta. Se questo non succede o se viene utilizzata una chiave API non valida, l’API riporta il messaggio d’errore “100”. Per poter ricevere la nuova chiave API, ti preghiamo di contattare il nostro supporto e cambieremo subito la tua chiave API.

Sistema di crediti

I crediti sono addebitati sul tuo account a seconda dei dati richiesti. I rispettivi costi dei crediti sono elencati a fianco delle descrizioni. I crediti sul tuo account si ricaricano di notte, tra domenica a lunedì. Per ogni iscrizione a un modulo toolbox, l’account sarà accreditato con 10.000 crediti. I crediti non si accumulano dalla settimana precedente. In caso di iscrizione a tutti i 5 moduli toolbox e si abbia bisogno di ulteriori crediti per l’API, possono essere raggiunti accordi individuali. Per questo, ti preghiamo di contattare il supporto toolbox. La quantità di crediti rimanenti può essere ottenuta attraverso l’API:

https://api.sistrix.com/credits?api_key=$key

Formato di output

Tutti i valori delle richieste e delle risposte sono codificati in UTF-8. Normalmente, le risposte dell’interfaccia API hanno luogo in formato XML. Alternativamente, puoi ricevere i dati nel formato JSON. Per questo, il parametro “format” deve essere aggiunto a ogni URL, con il valore “json”.

https://api.sistrix.com/...?format=json

Selezione del paese

Se nessun paese è selezionato esplicitamente, tutti i valori restituiti si riferiranno ai dati di toolbox della Germania. Gli altri paesi possono essere selezionati attraverso la trasmissione dei parametri “country”.

Valori possibili per il parametro del paese (country): de, at, ch, it, es, fr, pl, nl, uk, us, se, br, tr

https://api.sistrix.com/...?country=$country

Base di dati estesa

Le richieste dell’API hanno luogo, in automatico, sul database standard della toolbox. Questi includono due milioni di parole chiave per nazione – rispettivamente, un milione per i risultati desktop e un milione per i dati smartphone. In aggiunta, in alcune nazioni offriamo un database esteso con milioni di altre parole chiave. Queste Parole Chiave sono aggiornate mensilmente invece che settimanalmente, ma sono considerevolmente più esaurienti. In modo da raggiungere il database esteso attraverso l’API, il parametro “extended” deve essere impostato sul valore “true”

https://api.sistrix.com/...?extended=true

Dati smartphone

In aggiunta ai risultati di ricerca desktop, la toolbox calcola anche i risultati per ricerche effettuate da smartphone. In modo da recuperare questi risultati attraverso l’API, il parametro “mobile” deve essere impostato sul valore “true”. Il database esteso non è disponibile per i dati smartphone, di conseguenza una combinazione con “extended” non è possibile.

https://api.sistrix.com/...?mobile=true