Q: Posso eliminare il mio account Openapi?

Sì, attraverso la tua area privata. Vai sulla sezione Preferenze : in basso troverai il box Cancella il tuo account . ATTENZIONE: se clicchi sul tasto “Procedi” i tuoi dati saranno cancellati in modo permanente e i token saranno invalidati. Questa azione non può essere annullata.

Q: Come funziona l’area Sandbox?

L’area Sandbox è stata pensata per effettuare tutti i test prima di pubblicare in produzione le integrazioni. Le richieste test sono completamente gratuite ma prima di procedere fare le richieste è necessario impostare il "credito sandbox" . Le risposte in ambiente sandbox sono a titolo di esempio e potrebbero non essere complete. Per alcune API saranno disponibili delle partite IVA da utilizzare per i tuoi test.

Question 1

Come posso registrarmi su Openapi?

Accepted Answer

Su Openapi è possibile registrarsi tramite:

Account Google
Account Github
Indirizzo Email

In quest’ultimo caso riceverai in pochi secondi un'email con le istruzioni per completare la registrazione.

Question 2

Non mi è arrivata l’email dopo la registrazione, cosa fare?

Accepted Answer

L’email verrà inviata solo a chi ha selezionato come modalità di registrazione inserimento email, non a chi ha fatto la registrazione tramite account Google.

Se hai completato la registrazione con l’email e non hai ricevuto conferma ti suggeriamo di verificare che la nostra comunicazione non sia:

nella scheda Promozioni o Aggiornamenti (indirizzi GMAIL)
nella posta indesiderata o spam

Hai controllato e non hai risolto? Nessun problema, contattaci tramite il form di Assistenza.

Question 3

Posso modificare la mia password?

Accepted Answer

È possibile effettuare la modifica password in caso di registrazione con email: accedi alla tua area personale, nella sezione Preferenze potrai procedere a modificare la password.

Question 4

Ho dimenticato la password, come posso fare?

Accepted Answer

La procedura di recupero password dipende dalla modalità scelta in fase di registrazione:

Registrazione tramite email: clicca su “I forgot my password” direttamente dall’area login.
Registrazione tramite indirizzo Gmail: segui le indicazioni sulla pagina Google dedicata.

Registrazione tramite Github: clicca su “Forgot password?” direttamente dall’area login.

Question 5

È possibile aggiungere un ulteriore utente al proprio account Openapi?

Accepted Answer

No, attualmente ogni account è associato ad un'unica email e non può essere aggiunto nessun altro utente. Può essere però aggiunta una ulteriore email per le notifiche.

Question 6

Posso eliminare il mio account Openapi?

Accepted Answer

Sì, attraverso la tua area privata. Vai sulla sezione Preferenze: in basso troverai il box Cancella il tuo account.
ATTENZIONE: se clicchi sul tasto “Procedi” i tuoi dati saranno cancellati in modo permanente e i token saranno invalidati. Questa azione non può essere annullata.

Question 7

È possibile accedere a richieste gratuite?

Accepted Answer

Sì, alcune API consentono di effettuare un numero di richieste gratuite giornaliere e/o mensili. La disponibilità di queste richieste è visibile a livello di API nella sezione Prezzo.

Question 8

Come funziona l’area Sandbox?

Accepted Answer

L’area Sandbox è stata pensata per effettuare tutti i test prima di pubblicare in produzione le integrazioni. Le richieste test sono completamente gratuite ma prima di procedere fare le richieste è necessario impostare il "credito sandbox".

Le risposte in ambiente sandbox sono a titolo di esempio e potrebbero non essere complete. Per alcune API saranno disponibili delle partite IVA da utilizzare per i tuoi test.

Question 9

Come posso creare il Token?

Accepted Answer

È possibile ricevere il token in due modalità tramite:

l'API OAuth con lo scope POST htts://oauth.openapi.it/token
tool "Nuovo Token" presente nella sezione Autenticazione

Question 10

Dove posso visualizzare i miei token?

Accepted Answer

Per visualizzare i tuoi token accedi alla tua area privata, nella sezione Autenticazione.

Qui puoi anche creare un nuovo token, cliccando sul tasto +Nuovo Token.

Question 11

Come posso verificare se ci sono dei limiti (rate limit) sugli endpoint di mio interesse?

Accepted Answer

Eventuali limiti sono indicati nelle descrizioni delle singole API.

Question 12

Da quali fonti provengono i dati forniti da Openapi?

Accepted Answer

Ogni dato fornito da Openapi proviene da fonti ufficiali e certificate. In particolare le fonti sono le seguenti:

Account Social Aziende: Facebook, Twitter, LinkedIn
Agenzia delle Entrate: Dati Immobiliari e Catastali, Codice Fatturazione, Stato Attività Impresa, etc.
Centri di Assistenza Fiscale (CAF) territoriali
Certification Authority ed Identity Provider Europee: Firma digitale, SPID, marcatura temporale, conservazione e PEC massiva
Consiglio Nazionale delle Ricerche (CNR): in qualità di Registrar certificato per informazioni su siti web
CRIF: Dati Anagrafici, Economici, Dipendenti, Web ed Esponenti di Aziende italiane
IndicePA: indice delle pubbliche amministrazioni
INPS: dati trimestrali su numero dipendenti
Ministero dei Trasporti (su base Europea): informazioni e servizi Auto
Poste Italiane: API postalizzazione raccomandate, telegrammi, atti giudiziari in forma singola o massiva
Registro Imprese Camera di Commercio: Visure Camerali, Bilanci, XBRL, Info aziendali, etc.
Registro Protesti e altri registri: estrazione eventi negativi e calcolo relativi score
Sistema proprietario di calcolo, rielaborazioni e previsioni dati: bilanci d’esercizio, gruppi finanziari etc.
Siti Web Aziende: meta-informazioni e testo delle pagine web

Question 13

Perché è necessaria la procedura di invio documento di identità per attivare alcune API?

Accepted Answer

Solo per alcuni servizi che sono soggetti al TULPS e relativa licenza (articolo 6 della licenza TULPS) è previsto l'obbligo di identificazione tramite documento di identità della persona o azienda che richiede il servizio stesso.

Question 14

Quale documento devo caricare per la verifica dell'identità per l'utilizzo di alcune API?

Accepted Answer

Per alcuni servizi la normativa TULPS prevede l'identificatore dell'utilizzatore del servizio.
Nel caso di società quindi viene richiesto di caricare un documento di identità (patente, passaporto, carta d'identità) che può essere o del legale rappresentante o di una persona con poteri di firma o un delegato per l'erogazione e l'utilizzo del servizio specifico (es. responsabile IT o ufficio amministrativo)

Question 15

Posso contattarvi per assistenza?

Accepted Answer

Sì, siamo disponibili per supporto e richieste connesse alle nostre API. Compila il form di Assistenza e ti daremo riscontro nel più breve tempo possibile.

Question 16

Vorrei ricaricare il mio credito, come fare?

Accepted Answer

Accedi alla tua area personale e clicca su Transazioni, poi su Ricarica il tuo wallet. Seleziona l’importo desiderato e procedi al pagamento.

In quest'area puoi anche attivare l’opzione Autoricarica, ovvero la ricarica automatica, che ti permette di richiedere la ricarica in automatico del credito quando questo scende sotto una certa soglia. Non ti dovrai così più preoccupare di effettuare il pagamento ogni volta che il tuo credito sta per terminare.

Imposta una soglia minima e un importo di ricarica: la ricarica automatica partirà solo se la tua disponibilità è inferiore al limite indicato e potrai disattivarla in qualsiasi momento. Opzione prevista solo per il pagamento con carta di credito.

Question 17

Quali sono le modalità di pagamento?

Accepted Answer

Le modalità di pagamento per la ricarica del borsellino o per l’attivazione di un abbonamento sono le seguenti:

PayPal
Carta di Credito
Bonifico

La modalità Carta di Credito prevede l'attivazione del pagamento ricorrente nel caso in cui si scelga un abbonamento mensile o annuale. Il pagamento ricorrente può essere disattivato in qualsiasi momento attraverso la propria Area privata.

Inoltre è possibile attivare anche la funzionalità di autoricarica, cioè impostare una soglia minima ed un importo di ricarica per avere sempre credito in Openapi. La ricarica automatica partirà solo se la tua disponibilità sarà inferiore al limite indicato e potrai disattivarla in qualsiasi momento. L’opzione è attivabile in fase di acquisto ed è disponibile solo per pagamento con Carta di Credito.

Question 18

Quali sono le differenze tra richieste singole ed in abbonamento?

Accepted Answer

Su Openapi è possibile effettuare richieste tramite borsellino (quindi pagate singolarmente) o in abbonamento.

Le principali differenze tra richieste singole ed in abbonamento sono:

Numero di richieste disponibili: Ogni abbonamento prevede un limite di richieste, mensile o annuale, mentre per le richieste singole non c’è un limite ma è necessario avere sufficiente credito nel borsellino.
Costo della richiesta: Il costo della richiesta tramite abbonamento (mensile o annuale) è più conveniente rispetto alla richiesta singola.

Question 19

Come funziona l’autoricarica?

Accepted Answer

La funzionalità di autoricarica è attivabile in fase di pagamento e consente di avere sempre credito disponibile nel tuo account Openapi.

In fase di acquisto potrai impostare una soglia minima ed un importo di ricarica. La ricarica automatica partirà solo se la tua disponibilità sarà inferiore al limite indicato. La funzionalità di autoricarica può essere disattivata in qualsiasi momento.

L’opzione è disponibile in fase di pagamento con Carta di Credito.

Question 20

Vorrei attivare un abbonamento, come fare?

Accepted Answer

È possibile selezionare il piano di abbonamento desiderato nella sezione dedicata a livello di API.

Question 21

Come funzionano gli abbonamenti mensili ed annuali?

Accepted Answer

L'abbonamento mensile e l'abbonamento annuale si differenziano per:

modalità di addebito
limiti di richieste

L'abbonamento mensile ha una durata di 30 giorni ed eventuali richieste residue non possono essere utilizzate nel mese successivo neanche in caso di rinnovo.

L'abbonamento annuale ha una durata di 365 giorni e le richieste, al netto di rate limit specifici per singole API, possono essere utilizzate in base all'esigenza del cliente, durante tutto l'anno o in un arco più limitato di tempo.

Question 22

Qual è la differenza tra abbonamento annuale e abbonamento mensile pagato in anticipo per 12 mesi?

Accepted Answer

L'abbonamento annuale non prevede limiti di consumo mensili, al netto di rate limit previsti a livello di API. In pratica è possibile effettuare le richieste in qualsiasi periodo dell'anno.

L'abbonamento mensile con pagamento anticipato per 12 mesi invece prevede gli stessi limiti di chiamate del mensile "normale" ma consente di risparmiare rispetto a questo.

Question 23

Posso verificare lo stato del mio/miei abbonamento/i?

Accepted Answer

Sì, attraverso la tua area personale. Vai alla sezione Abbonamenti e troverai lo stato e il report sull’utilizzo del o degli abbonamenti da te attivati.
È possibile verificare i consumi del proprio abbonamento anche nella sezione dedicata a livello di API.

Question 24

Le opzioni “Pagamento in abbonamento” e “Pagamento per singola richiesta” possono coesistere?

Accepted Answer

Nello stesso account è possibile selezionare modalità di pagamento differenti per ogni API. Ad esempio è possibile attivare un abbonamento mensile o annuale per l’utilizzo di alcune API e, allo stesso tempo, pagare l’utilizzo di altri services a singola richiesta.

In caso di attivazione di abbonamenti suggeriamo sempre di avere un minimo di credito nel borsellino. In questo modo, anche se le richieste previste dall’abbonamento dovessero terminare, potrai comunque continuare ad utilizzare le API con le richieste singole.

Question 25

Ho terminato le richieste previste dal mio abbonamento e ho bisogno di averne nuove. Cosa posso fare?

Accepted Answer

Se hai terminato le richieste previste dal tuo abbonamento prima della scadenza, puoi scegliere di:

rinnovare subito l’abbonamento precedente
sottoscrivere un qualsiasi altro tipo di abbonamento, con costi e durata diversi da quello precedente
non sottoscrivere alcun abbonamento ed utilizzare le richieste singole.

In questo caso è necessario verificare il proprio credito ed eventualmente ricaricare il borsellino. L’addebito avverrà per singola richiesta.

Question 26

Posso verificare i miei consumi?

Accepted Answer

Certo, è possibile verificare i consumi delle chiamate singole o del proprio abbonamento e a livello di API nel tab dedicato.

Oauth V2

La chiave di accesso in sicurezza a tutte le API.