Question 1

Cosa succede se un nome può essere sia maschile che femminile?

Accepted Answer

A seconda della versione dell'API o dell'integrazione che usi, i nostri endpoint restituiscono nella risposta un valore di accuratezza o di probabilità. Il parametro di accuratezza indica quanto siamo sicuri che il nome sia maschile o femminile. Il valore è calcolato in base al numero di record presenti nel nostro database: ad esempio, se abbiamo 100 campioni di un nome, di cui 96 femminili e 4 maschili, l'accuratezza è del 96% (ovvero una probabilità di 0,96). Un'accuratezza bassa indica che il nome è probabilmente usato da più generi e non può essere ricondotto a un genere specifico.

Question 2

Possono esserci differenze per lo stesso nome a seconda del paese?

Accepted Answer

Il nome Andrea è maschile in Italia, mentre in Germania è un nome femminile e negli Stati Uniti può essere entrambi.
In questo caso forniamo un valore di accuratezza nel risultato della ricerca, compreso tra 0 e 100 (o un valore di probabilità tra 0 e 1).
Indica quanto siamo certi di aver rilevato il genere corretto.
Puoi migliorare molto la qualità dei risultati dell'API fornendo un'informazione geografica sulla tua ricerca: può essere un codice paese, il locale del browser o un indirizzo IP. Scopri di più sulla localizzazione di una ricerca nella nostra documentazione API.

Question 3

Come raccogliete i dati?

Accepted Answer

Per fornire la massima accuratezza possibile, combiniamo dati da diverse fonti. Le principali fonti per nuovi record sono dati pubblicamente disponibili, dati governativi ed aggiunte/correzioni manuali. In base alla fonte di un nuovo nome, il nome potrebbe dover essere verificato da una seconda fonte prima di venir aggiunto alla nostra lista. 
        Ad esempio, se aggiungiamo un nome da dati pubblicamente disponibili, questo nome potrebbe necessitare di una seconda verifica, come una conferma manuale, prima di essere definitivamente aggiunto al nostro database.
        Puoi trovare una lista dei paesi supportati qui.

Question 4

Quanto spesso aggiornate i record dei nomi?

Accepted Answer

Aggiorniamo regolarmente i nostri dati a seconda del paese e dei dati pubblici disponibili. 
La maggior parte dei paesi occidentali viene aggiornata una volta all'anno. Inoltre, la distribuzione dei nomi in base al genere può cambiare nel corso degli anni.
Ad esempio, se un nome veniva usato solo dalle donne negli anni '70, potrebbe essere usato prevalentemente da uomini decenni dopo.
È per questo che utilizziamo anche i dati di nascita per diversi paesi, come gli Stati Uniti, per arricchire i risultati. I nostri modelli cercano di prendere in considerazione tutti questi fattori nel modo migliore possibile.
Il valore di accuratezza restituito viene regolarmente aggiornato per riflettere l'effettivo utilizzo nella popolazione, il più accuratamente possibile. Il valore dovrebbe fornire una valutazione ragionevole basata sugli ultimi decenni e potrebbe esprimere una possibile fluttuazione.
Guardiamo circa gli ultimi 4 decenni dei dati. 
Se esegui una query e ripeti la stessa query un anno dopo, potresti ottenere un risultato diverso perché il nostro sistema potrebbe aver eliminato vecchi dati e potrebbero essere stati aggiunti nuovi dati.
Ogni volta che vengono aggiunti nuovi dati, effettuiamo dei cosiddetti test di integrazione successivamente.
In questo processo, la nostra API viene testata rispetto a un set di dati convalidati in precedenza per garantire la qualità.
Questo set di dati viene continuamente ampliato con nomi e casi di test per ottenere la copertura più ampia possibile.

Question 5

Come sfruttate l'AI?

Accepted Answer

L'intelligenza artificiale (AI) viene utilizzata quotidianamente per migliorare la qualità del nostro database e dei risultati dell'API. Grazie all'AI, possiamo aggiungere nuove voci al nostro database in modo efficiente e accurato, garantendo che le nostre informazioni siano sempre aggiornate. 

Inoltre, l'AI gioca un ruolo cruciale nel migliorare la qualità complessiva dei risultati dell'API. Sfruttando gli algoritmi di apprendimento automatico, possiamo analizzare i dati in modo più efficace, identificare i modelli e fornire risultati più precisi e rilevanti ai nostri utenti.

Question 6

Fornite aiuto per implementare l'API?

Accepted Answer

Sì, forniamo supporto via email a tutti i clienti. Puoi inviarci un'email a contact gender-api.com. Ti risponderemo il prima possibile. Puoi anche trovare esempi di codice qui. 
Tieni presente che non possiamo aiutarti con ogni linguaggio di programmazione e caso d'uso. 
Nella maggior parte dei casi, puoi utilizzare un client REST standard nella tua app per interrogare la nostra API. 
Molte librerie supportano anche l'importazione di un file di definizione OpenAPI. Puoi scaricare il nostro file di definizione openapi.yml qui.

Question 7

Cosa succede se abbiamo bisogno di un alto livello di accuratezza?

Accepted Answer

Le lingue e i nomi sono fluidi e cambiano nel tempo. Da un cliente all'altro, i set di dati variano molto in termini di qualità, portata ed origine. Pertanto non possiamo garantire che tutti i risultati che riceverai dalla nostra API siano corretti al 100% e corrispondano al tuo pool di dati. Ma possiamo prometterti che siamo sempre impegnati a fornirti i migliori risultati possibili e che miglioriamo e aggiorniamo regolarmente i nostri algoritmi. Aggiungiamo anche nuovi dati su base molto regolare. Puoi scoprire di più sui nostri aggiornamenti qui. Nell'improbabile caso in cui il nostro servizio non soddisfi le tue aspettative, ti offriamo una semplice garanzia di rimborso entro 14 giorni.
Naturalmente puoi anche provare il nostro servizio in modo completamente gratuito. Se ti registri qui, riceverai 100 richieste gratuite ogni mese.
Quando cerchi un nome, i nostri endpoint restituiscono nella risposta un valore di accuratezza o di probabilità, a seconda della versione dell'API.
Il parametro di accuratezza indica quanto siamo sicuri che il nome sia maschile o femminile.
Il valore è calcolato in base al numero di record presenti nel nostro database.
Poiché i casi d'uso sono molto diversi tra loro, non diamo raccomandazioni sul livello di accuratezza: in base al tuo caso d'uso sta a te decidere quali risultati e quali livelli di accuratezza accettare.
Anche con un'accuratezza di almeno il 99%, esiste la possibilità che il risultato sia sbagliato.
In generale, però, un valore superiore al 95% è adatto alla maggior parte dei casi d'uso.

Question 8

Quanti nomi avete memorizzato nel vostro database?

Accepted Answer

Il nostro database contiene 6,084,389 nomi validati da 191 paesi diversi. In tutto il mondo conserviamo 6,471,712 nomi unici.
In media analizziamo circa 10.000.000 di dataset al mese per migliorare la qualità dei nostri risultati.

Question 9

Quali paesi sono supportati?

Accepted Answer

L'API supporta completamente 191 paesi. Il supporto completo significa che abbiamo raccolto almeno  nomi
                        in questo rispettivo paese. Tuttavia, in molti paesi il nostro dataset è molto più grande. Dai un'occhiata alla seguente tabella per
                        avere maggiori informazioni su quanti nomi supportiamo in ogni paese. Tieni presente che se non forniamo un supporto adeguato per un
                        certo paese, puoi comunque cercare i nomi richiesti per l'intero dataset per ottenere un risultato adeguato.

Question 10

Supportate i nomi arabi?

Accepted Answer

Sì, la nostra API supporta i nomi arabi. Possono anche essere scritti con caratteri dell'alfabeto arabo.
L'arabo si scrive da destra a sinistra in corsivo e comprende 28 lettere.
Ad esempio, se cerchi "عبد ال" ottieni questo risultato: "gender": "male", "accuracy": 100.
Il nome arabo "عبد ال" in questo esempio è codificato per l'URL e l'URL della query sarà: https://gender-api.com/get?name=%D8%B9%D8%A8%D8%AF%20%D8%A7%D9%84&key=YOUR_API_KEY.
Trovi l'elenco completo dei paesi supportati qui.

Question 11

Posso interrogare più nomi in una sola richiesta?

Accepted Answer

Sì, è assolutamente possibile: puoi cercare fino a 100 nomi alla volta.
                        Per i dettagli dai un'occhiata alla nostra documentazione API.

Question 12

Ho sentito parlare della vostra API per le email. Di cosa si tratta esattamente?

Accepted Answer

La nostra API per le email può estrarre i nomi dagli indirizzi email e restituire il genere corrispondente a quell'indirizzo. Ti aiuta a personalizzare le tue email con la formula di saluto giusta. Ad esempio, dall'indirizzo email "marie.johnson@gmail.com" l'API estrae il nome "Marie" e determina il genere corretto, cioè "female". Per i dettagli dai un'occhiata alla nostra documentazione API.

Question 13

Ho una grande quantità di dati. Posso caricare in blocco un file CSV?

Accepted Answer

Come utente registrato puoi caricare qualsiasi file CSV che contenga una colonna di nomi. Per un risultato di determinazione migliore, puoi aggiungere facoltativamente una colonna con il paese al tuo dataset. Non è necessario dare nomi specifici alle colonne: il nostro assistente ti guida nel processo e ti fa scegliere quale colonna contiene quale valore, nome o paese compresi. La funzione si trova nel tuo account. I record elaborati vengono addebitati come richieste, quindi ogni mese puoi caricare gratuitamente un file CSV con un massimo di 100 voci. Il caricamento CSV in blocco richiede un account Gender-API.com. Per motivi di protezione dei dati, i file caricati vengono eliminati automaticamente dopo un anno.

Question 14

Come deve essere formattato il file CSV?

Accepted Answer

Supportiamo i file CSV creati su Windows, macOS o Linux.
        Supportiamo inoltre i file con delimitatori come ";", "," o la tabulazione. Il carattere di delimitazione dei valori deve essere ".
        Puoi caricare file CSV multiriga con un massimo di 10.000.000 di righe e 301MB.
        Per ottenere i migliori risultati ti consigliamo un file CSV in UTF-8 con il punto e virgola come delimitatore.
        Per il resto il file CSV può contenere altre colonne arbitrarie, che verranno incluse anche nel file di output.
        Il file deve avere almeno una colonna con soli nomi oppure una colonna con nomi completi.
        Clicca qui per scaricare un file di esempio. Crea un account Gender-API.com per caricare un file CSV.

Question 15

Posso caricare un file Excel?

Accepted Answer

Puoi caricare file Excel con un massimo di 300.000 righe. Per dataset più grandi usa il caricamento di file CSV.
Supportiamo i file .xlsx con un solo foglio. Se carichi un file con più di un foglio, verrà elaborato solo il primo.
La prima riga del foglio deve contenere i nomi delle colonne. Il file deve contenere almeno una colonna con i nomi; la colonna del paese è facoltativa. Per motivi di protezione dei dati i file caricati vengono eliminati automaticamente dopo un anno. Scarica il file di esempio qui. Esempio:

Question 16

Ho trovato un errore. Cosa dovrei fare?

Accepted Answer

Apprezziamo molto il tuo aiuto. Mandaci un'email a contact gender-api.com e cercheremo di risolvere il bug il prima possibile.

Question 17

Gender-API è conforme al Regolamento generale sulla protezione dei dati (GDPR)?

Accepted Answer

Tutti i servizi di Gender-API.com sono pienamente conformi al GDPR.
Forniamo un Accordo sul trattamento dei dati (DPA) che ti permette di rispettare i tuoi obblighi GDPR.
Puoi richiedere questo accordo qui nel tuo account. Un accordo di esempio si può scaricare qui.
Inoltre, qui trovi maggiori informazioni su come proteggiamo i tuoi dati.

Question 18

Fornite librerie per linguaggi di programmazione?

Accepted Answer

A causa della semplicità della nostra API, non forniamo librerie per nessun linguaggio di programmazione, eccetto il plugin jQuery. La maggior parte dei linguaggi supporta un parser json già integrato e per quasi tutti gli altri linguaggi, c'è già una libreria esterna che puoi utilizzare. Dai un'occhiata ai nostri esempi di codice per iniziare ad utilizzare l'API:

Question 19

Come vengono contate le richieste?

Accepted Answer

Ogni account verrà ricaricato a 100 richieste il primo giorno di ogni mese se sono rimaste meno di questo numero di richieste.
                Solo se viene trovato un risultato, la richiesta verrà conteggiata. Una ricerca di un nome verrà conteggiata come una richiesta. 
                Se in un'unica query vengono richiesti più nomi, ciascun nome verrà conteggiato come una singola richiesta.

Question 20

Dove posso trovare e gestire le mie chiavi API?

Accepted Answer

Generiamo una chiave API iniziale quando ti registri per un account Gender-API.com. Trovi questa chiave API in fondo alla pagina di panoramica del tuo account. Se vuoi revocarla, clicca sul pulsante "Revoca e Rigenera". Il nostro sistema invaliderà la chiave API esistente e ne genererà una nuova. Tutte le tue applicazioni che usano il vecchio token non potranno più accedere alla nostra API finché non sostituirai questo codice con la nuova chiave API. [apiKeyImage] Puoi anche creare più di una chiave API. È utile, ad esempio, se hai più applicazioni in cui vuoi includere la nostra API. Tieni presente che non c'è distinzione tra le chiavi e il numero di richieste che ognuna ha consumato: tutte le richieste vengono conteggiate complessivamente. Per gestire o creare più chiavi API, clicca sul pulsante "Impostazioni" nel menu dell'account e poi su "Chiavi API". [multipleKeysImage] Cliccando sul pulsante "Crea nuova chiave" puoi generare una nuova chiave API. Puoi dare un nome a ogni token per riconoscere più facilmente dove è stata usata la chiave; puoi cambiare questo nome in qualsiasi momento. Inoltre, alcuni dei nostri widget generano qui una chiave automaticamente: ad esempio, se usi il nostro "Quick Lookup Widget" nel tuo account, il sistema genera in anticipo una chiave e il widget la usa poi per interrogare la nostra API. Anche le app di terze parti creano qui una chiave una volta connesse. Ogni token può essere revocato in qualsiasi momento cliccando sulla "x". Una volta revocato, l'applicazione connessa non avrà più accesso alla nostra API.

Question 21

Posso condividere il mio account con più persone?

Accepted Answer

Puoi condividere il tuo account con altri 50 colleghi o altre persone collegate al tuo progetto. Per gestire il tuo team accedi al tuo account e, nel menu dell'account, clicca su "Impostazioni" => "Gestisci il tuo team". In questa pagina clicca sul pulsante "Invita un nuovo membro" per invitare persone nel tuo team via email. Quando inviti un membro puoi scegliere tra due tipi di account.
        A) Gli utenti possono visualizzare, creare, aggiornare ed eliminare le chiavi API, caricare file CSV ed Excel e determinarne il genere, accedere a tutti gli endpoint dell'API, acquistare richieste e collegare app di terze parti. B) Gli amministratori possono fare tutto quello che fanno gli utenti e, in più, aggiornare le impostazioni dell'account e l'indirizzo di fatturazione, creare e consultare gli accordi sul trattamento dei dati e invitare, aggiornare ed eliminare i membri del team.

Question 22

Posso proteggere il mio account abilitando la verifica in due passaggi?

Accepted Answer

Puoi proteggere il tuo account attivando la verifica in due passaggi. Per attivare questa misura di sicurezza aggiuntiva accedi al tuo account e, nel menu dell'account, clicca su "Impostazioni" => "Cambia password / 2FA". Assicurati di avere un'app di autenticazione installata sul telefono. Ti consigliamo un'app come Authy (App Store, Play Store) o Google Authenticator (App Store, Play Store).
Clicca poi sul pulsante "Abilita ora" e segui le istruzioni sullo schermo. Qui puoi aggiungere più dispositivi per assicurarti, ad esempio, di avere ancora accesso al tuo account dopo aver perso un dispositivo.
Una volta attivata, per accedere ti verrà richiesto di inserire il codice generato dall'app di autenticazione del tuo telefono.

Question 23

Posso utilizzare applicazioni di terze parti quando è attivata la verifica in due passaggi?

Accepted Answer

Alcune integrazioni o applicazioni di terze parti funzionano perfettamente con la verifica in due passaggi abilitata. Altre potrebbero richiedere 
di connettersi senza la verifica in due passaggi. Se riscontri problemi nell'accesso ad alcune applicazioni con le credenziali di Gender-API.com, accedi direttamente al tuo account su Gender-API 
e fai clic su "Impostazioni" => "Cambia password / 2FA" nel menu dell'account. Quindi fai clic sulla scheda "Verifica in due passaggi" e imposta "Accesso app di terze parti" su "Non limitato". 
Nota bene, è possibile modificare questa impostazione solo se la verifica in due passaggi è abilitata.

Question 24

Cosa sono le passkey e come funzionano?

Accepted Answer

Le passkey sono un metodo di autenticazione moderno e senza password che offrono una maggiore sicurezza rispetto alle password tradizionali. 
 Invece di inserire una password, puoi accedere utilizzando le funzionalità di sicurezza integrate del tuo dispositivo come Face ID, Touch ID, Windows Hello o un PIN. 
 Le passkey si basano sullo standard WebAuthn e sono resistenti al phishing perché sono crittograficamente legate a siti web specifici. 
 La tua chiave privata non lascia mai il tuo dispositivo, rendendo le passkey più sicure delle password. Una volta impostata una passkey per il tuo account Gender-API.com, 
 puoi accedere con un semplice tocco o sguardo - nessuna password richiesta. Le passkey funzionano su diversi dispositivi e possono essere sincronizzate tramite iCloud Keychain, Google Password Manager o servizi simili.

Question 25

Come posso configurare una passkey per il mio account?

Accepted Answer

La configurazione di una passkey avviene automaticamente durante il processo di accesso. Quando accedi con la tua email e password, ti verrà richiesto di creare una passkey per accessi futuri più rapidi. Segui semplicemente le istruzioni sul tuo dispositivo: il browser ti chiederà di verificare la tua identità utilizzando Face ID, Touch ID, Windows Hello o il PIN del tuo dispositivo. Una volta verificata, la passkey verrà salvata automaticamente sul tuo dispositivo e sarà pronta all'uso. La prossima volta che visiterai Gender-API.com, potrai accedere istantaneamente solo con la tua passkey invece di digitare la password. Puoi saltare la configurazione della passkey se preferisci continuare a utilizzare la tua password. Nota: Le passkey richiedono un browser compatibile (Chrome, Safari, Edge, Firefox) e un sistema operativo compatibile.

Question 26

In cosa differiscono le passkey dalla verifica in due passaggi (2FA)?

Accepted Answer

Anche se entrambe migliorano la sicurezza, funzionano in modo diverso. La verifica in due passaggi (2FA) aggiunge un secondo fattore dopo che hai inserito la password, in genere un codice da un'app di autenticazione. Le passkey sostituiscono completamente la password e offrono una sicurezza multifattore in un unico passaggio, combinando qualcosa che hai (il tuo dispositivo) con qualcosa che sei (la biometria) o che sai (il PIN del dispositivo). Le passkey sono considerate più sicure perché: resistono al phishing (funzionano solo sul sito autentico), non sono vulnerabili alle violazioni dei database delle password e non possono essere indovinate o forzate. Se hai attivato sia le passkey sia la verifica in due passaggi, l'accesso con una passkey salta la richiesta di verifica, perché le passkey offrono già una sicurezza equivalente o superiore.

Question 27

Cosa succede se perdo il dispositivo con la mia passkey?

Accepted Answer

Se perdi un dispositivo con la tua passkey, non preoccuparti: il tuo account resta sicuro e accessibile.
Puoi sempre accedere con la tua password (e con la verifica in due passaggi, se attiva). Se le tue passkey sono sincronizzate tramite iCloud Keychain o Google Password Manager, saranno disponibili automaticamente sugli altri dispositivi collegati allo stesso account.
Per una sicurezza ottimale ti consigliamo di: configurare le passkey su più dispositivi, tenere la password come riserva e attivare la verifica in due passaggi come ulteriore livello di sicurezza. Puoi anche gestire le tue passkey nelle impostazioni del tuo account per rimuovere la passkey di un dispositivo smarrito ed evitare accessi non autorizzati.

Question 28

Qual è la differenza tra un account a pagamento e uno gratuito?

Accepted Answer

Entrambi i tipi di account offrono le stesse funzionalità. Tutti gli endpoint dell'API sono disponibili per entrambi i tipi di account e restituiscono gli stessi risultati.
        Gli account gratuiti sono limitati a un certo numero di richieste al mese. Quando ti registri hai subito a disposizione 100 richieste gratuite. Il primo giorno di ogni mese il nostro sistema azzera questo numero e le richieste gratuite tornano disponibili. Crea un solo account. Se ti servono più richieste, puoi passare in qualsiasi momento a uno dei nostri piani a pagamento qui.

Question 29

Come posso effettuare il logout da tutti i dispositivi?

Accepted Answer

Se clicchi sul pulsante di logout nel tuo account, verrai disconnesso solo dal dispositivo che stai usando.
Per garantire la sicurezza del tuo account e dei tuoi dati è importante disconnettersi da tutti i dispositivi quando serve. Segui le istruzioni qui sotto per disconnetterti da tutti i dispositivi della nostra piattaforma API.
Quando sei connesso, clicca qui per disconnetterti da tutti i dispositivi. Inoltre, se cambi la password o modifichi le impostazioni della verifica in due passaggi, il sistema ti disconnette automaticamente da tutti i dispositivi che non corrispondono al tuo indirizzo IP attuale. È un ulteriore livello di sicurezza per il tuo account. Ti consigliamo di creare account separati per ogni membro del team, per aumentare la sicurezza e facilitare la collaborazione.
Inoltre, per rendere il tuo account più sicuro, ti consigliamo vivamente di attivare la verifica in due passaggi (2FA). Questo ulteriore livello di protezione aggiunge un passaggio al processo di accesso e rende più difficile l'accesso a persone non autorizzate.

Question 30

Qual è la differenza tra un abbonamento e un pagamento una tantum?

Accepted Answer

Se vuoi acquistare uno dei nostri pacchetti puoi scegliere tra un pagamento una tantum e l'abbonamento al pacchetto.
          Gli abbonamenti sono consigliati se vuoi usare il nostro servizio con regolarità: hai la certezza di avere sempre abbastanza richieste residue nel tuo account.
          Le richieste acquistate con un abbonamento vanno usate entro un mese. Con un abbonamento attivo, dopo un mese il nostro sistema ricarica il tuo account fino alla quantità di richieste scelta. Ad esempio, se hai un abbonamento al pacchetto da 25.000 richieste e ne hai usate 21.500, dopo un mese il sistema riporta il tuo account a 25.000 richieste.
          I pacchetti una tantum si acquistano per un singolo caso d'uso e vanno usati entro un anno. Ad esempio, se vuoi elaborare un file Excel o CSV, ti consigliamo l'acquisto una tantum.
          Gli acquisti una tantum non si rinnovano: devi fare attenzione a non esaurire le richieste.
          Puoi passare da un tipo di pacchetto all'altro nella nostra pagina di acquisto.
          
          [difference]
Non mischiare i due tipi di acquisto se prima non hai parlato con il nostro supporto o non sai esattamente cosa stai facendo. Acquistare un pacchetto una tantum mentre hai un abbonamento a uno dei nostri pacchetti può impedire all'abbonamento di ricaricare le tue richieste: ad esempio quando dall'acquisto una tantum restano più richieste di quante l'abbonamento ne ricaricherebbe.

Question 31

Ho bisogno di un certificato di residenza fiscale. Potete emettere un certificato del genere?

Accepted Answer

Se ti serve un certificato di residenza fiscale della nostra azienda, contatta il nostro supporto indicando la tua richiesta. Il certificato deve essere richiesto singolarmente per ogni azienda. Nella richiesta indica l'indirizzo completo della tua azienda, il tuo paese di residenza e, se disponibile, la tua partita IVA.

Il certificato di residenza deve essere firmato dalla nostra agenzia delle entrate. Di solito servono 2-3 settimane per ricevere il modulo firmato, che possiamo poi fornirti come scansione digitale.

[certificate-of-residence]

Question 32

Come posso acquistare un pacchetto o altre richieste?

Accepted Answer

Puoi scegliere tra un piano in abbonamento e un pagamento una tantum qui.
Il pagamento una tantum è consigliato se vuoi elaborare un file CSV grande o se preferisci usare le tue richieste in modo irregolare.
Puoi ricaricare il tuo account con la quantità di richieste che ti serve in qualsiasi momento. Le richieste acquistate con il pagamento una tantum vanno usate entro un anno.
Se preferisci un piano in abbonamento, il tuo account verrà ricaricato ogni mese fino alla quantità di richieste scelta.
Gli abbonamenti possono essere modificati o annullati in qualsiasi momento.

Question 33

Come posso annullare il mio abbonamento?

Accepted Answer

Puoi modificare o annullare il tuo abbonamento in qualsiasi momento qui. Se vuoi interrompere i pagamenti ricorrenti, clicca sul pulsante "Annulla questo abbonamento".

Question 34

Qual è il tipico tempo di risposta dell'API?

Accepted Answer

La nostra API è progettata per offrire alte prestazioni e in genere risponde entro 10-200 millisecondi.  
I tempi di risposta possono variare leggermente in base alla tua posizione geografica, alle condizioni della rete e alla complessità della tua richiesta.  
Per le richieste batch con più nomi, il tempo di risposta aumenta in modo lineare. Utilizziamo una CDN globale e un’infrastruttura ottimizzata per garantire una bassa latenza in tutto il mondo. Se riscontri tempi di risposta costantemente lenti, contatta il nostro team di supporto.

Question 35

Ci sono limiti di frequenza o restrizioni sulle richieste?

Accepted Answer

Applichiamo limiti di utilizzo equi per garantire un servizio ottimale a tutti gli utenti.
Gli account gratuiti possono effettuare fino a 100 richieste al mese. Gli account a pagamento hanno limiti più alti:
1500 richieste al minuto e nessuna limitazione giornaliera finché hai crediti disponibili.
Se ti servono limiti più alti per il tuo caso d'uso, contattaci per parlare di un piano personalizzato.
Le richieste batch (fino a 100 nomi per richiesta) contano come singole richieste, ma sono più efficienti.

Question 36

Qual è la vostra garanzia di uptime dell'API?

Accepted Answer

Garantiamo un uptime dell'API del 99,9% su tutti i piani a pagamento. La nostra infrastruttura è ospitata su server di livello enterprise con failover automatico e bilanciamento del carico. Monitoriamo i nostri sistemi 24/7 e disponiamo di avvisi automatici per qualsiasi problema.
Offriamo anche un Service Level Agreement (SLA) per i clienti enterprise. Nel raro caso di un'interruzione prolungata, i clienti a pagamento ricevono crediti di servizio automatici in base ai termini del nostro SLA.

Question 37

Quale formato usa la risposta dell'API?

Accepted Answer

La nostra API restituisce le risposte in formato JSON per impostazione predefinita, che è ampiamente supportato da tutti i linguaggi di programmazione moderni. Ogni risposta include il nome richiesto, il genere rilevato, il valore di accuratezza/probabilità e metadati aggiuntivi. Ad esempio: {"name":"Maria","gender":"female","accuracy":99,"samples":12847,"country":"US"}. Puoi trovare schemi di risposta dettagliati nella nostra documentazione API e scaricare la nostra specifica OpenAPI per la generazione automatica del client.

Question 38

Come dovrei gestire gli errori dell’API?

Accepted Answer

La nostra API utilizza i codici di stato HTTP standard per indicare successo o errore.  
200 significa successo, 401 indica una chiave API non valida, 429 significa che è stato superato il limite di richieste e 500 indica un errore del server.  
Ogni risposta di errore include un messaggio descrittivo e un codice di errore per facilitare il debug.  
Ti consigliamo di implementare un backoff esponenziale per gli errori di limite di richieste e di mettere in cache le risposte andate a buon fine quando possibile.  
Per errori persistenti, consulta la nostra documentazione API o contatta il supporto.  
Tutti gli errori vengono registrati per facilitare la risoluzione dei problemi.

Question 39

Come gestite il versioning dell'API?

Accepted Answer

Attualmente manteniamo due versioni dell’API: V1 e V2. V2 è la nostra versione più recente con funzionalità avanzate, tra cui valori di probabilità, supporto esteso per i paesi e un'accuratezza migliorata. V1 rimane disponibile per garantire la compatibilità con le versioni precedenti, ma ti consigliamo di passare a V2 per le nuove integrazioni. Tutti gli endpoint dell’API includono la versione nel percorso dell’URL (ad es. /v2/name). Garantiamo che le versioni precedenti dell’API continueranno a funzionare. Le guide di migrazione sono disponibili nella nostra documentazione API. Le modifiche incompatibili vengono sempre comunicate con largo anticipo.

Question 40

Come gestite le variazioni dei nomi e i soprannomi?

Accepted Answer

Il nostro database include le varianti dei nomi più comuni, i diminutivi e i soprannomi. Ad esempio, "Bob" viene riconosciuto come variante di "Robert" e "Liz" come variante di "Elizabeth". Ti consigliamo però di cercare il nome completo quando è disponibile, per la massima accuratezza. I nostri sistemi di AI imparano continuamente nuove varianti dal nostro dataset. Se trovi un soprannome che non viene riconosciuto, faccelo sapere e lo aggiungeremo al nostro database. Le varianti regionali (come "Juan" e "John") sono gestite tramite i nostri dataset specifici per paese.

Question 41

L'API supporta nomi con caratteri speciali e accenti?

Accepted Answer

Sì! La nostra API supporta completamente i caratteri Unicode, incluse le lettere accentate (é, ñ, ü), 
        umlaut, segni diacritici e gli alfabeti non latini (arabo, cirillico, cinese, ecc.). I nomi devono essere codificati in UTF-8 nelle 
        richieste API. Per esempio, "François", "José", "Müller" e "Søren" vengono tutti elaborati correttamente. 
        La codifica URL è gestita automaticamente dalla maggior parte dei client HTTP, ma assicurati di usare la codifica corretta per i caratteri speciali. 
        Il nostro database contiene nomi da 191 paesi e copre tutti i principali sistemi di scrittura. Maggiori dettagli nella nostra documentazione API.

Question 42

Quali fonti di dati usate?

Accepted Answer

Combiniamo più fonti di dati autorevoli per garantire la massima accuratezza. Tra queste: dati dei censimenti governativi e registri di nascita di numerosi paesi, database di nomi pubblicamente disponibili, social media e reti professionali (anonimizzati e conformi al GDPR), archivi storici dei nomi e verifiche manuali del nostro team dati. Tutte le fonti sono verificate con cura e confrontate tra loro. Diamo priorità alle fonti governative ufficiali quando disponibili. I nostri modelli di AI aiutano anche a individuare schemi e a verificare la coerenza tra le fonti. Trovi l'elenco completo dei paesi supportati qui. Aggiorniamo regolarmente il nostro database quando diventano disponibili nuovi dati ufficiali.

Question 43

Come garantite la privacy e la protezione dei dati?

Accepted Answer

Prendiamo la privacy molto seriamente e rispettiamo il GDPR, il CCPA e le altre normative internazionali sulla protezione dei dati. Non conserviamo i nomi che cerchi oltre al logging necessario al funzionamento del servizio. Tutte le comunicazioni con l'API sono cifrate tramite HTTPS/TLS. Offriamo accordi sul trattamento dei dati per i clienti enterprise. I file CSV/Excel che carichi vengono eliminati automaticamente dopo un anno. Non vendiamo né condividiamo mai i dati dei clienti con terze parti. I nostri server si trovano in data center europei sicuri. Puoi leggere l'informativa sulla privacy completa per tutti i dettagli. Controlli di sicurezza periodici garantiscono la conformità continua.

Question 44

Posso ricevere fatture e ricevute per i miei pagamenti?

Accepted Answer

Sì, le fatture vengono generate automaticamente per tutti gli acquisti e le trovi nella tua dashboard dell'account. Puoi scaricare le fatture in PDF in qualsiasi momento e ti vengono inviate anche all'indirizzo email registrato.
Le fatture includono tutti i dati necessari a fini contabili, compresi i dati IVA ove applicabile.
Puoi aggiornare in qualsiasi momento i dati di fatturazione e i dati della tua azienda, così che le fatture riportino le informazioni corrette.
Per le fatture passate o per esigenze di fatturazione particolari, contatta il supporto.

Question 45

Qual è la vostra politica di rimborso?

Accepted Answer

Offriamo una semplice garanzia di rimborso entro 14 giorni per il primo acquisto.
Se il nostro servizio non soddisfa le tue aspettative nei primi 14 giorni, contattaci per un rimborso completo, senza fare domande.
Per i pagamenti in abbonamento puoi annullare in qualsiasi momento per interrompere gli addebiti futuri. I crediti non utilizzati degli acquisti una tantum restano validi per un anno. Forniamo rimborsi anche per problemi tecnici o malfunzionamenti del servizio, valutati caso per caso.
Leggi le nostre condizioni di disdetta complete per i dettagli oppure contatta il supporto per qualsiasi domanda.

Question 46

Quali integrazioni di terze parti sono disponibili?

Accepted Answer

Offriamo integrazioni con piattaforme e strumenti popolari, tra cui Zapier, Make (precedentemente Integromat), 
        Google Sheets, Microsoft Excel, Salesforce, HubSpot e molti sistemi CRM. La nostra API funziona con qualsiasi piattaforma che supporti 
        API REST o webhook. Forniamo connettori pronti all’uso e guide di integrazione dettagliate per le principali piattaforme. 
        Puoi anche usare la nostra funzione di caricamento CSV per un’elaborazione dei dati una tantum senza alcuna integrazione. 
        Per integrazioni personalizzate o il supporto di piattaforme specifiche, controlla la nostra documentazione o contatta il supporto.

DOMANDE FREQUENTI