Question 1

Que se passe-t-il si un nom peut être utilisé à la fois pour les hommes et les femmes ?

Accepted Answer

A seconda della versione dell'API o dell'integrazione che stai utilizzando, i nostri endpoint restituiranno un valore di accuratezza o di probabilità nella risposta. Il parametro di accuratezza restituisce quanto siamo sicuri che questo nome sia maschile o femminile. Il valore è calcolato dal numero di record nel nostro database. Ad esempio, se abbiamo 100 campioni di un nome, 96 sono femminili e 4 sono maschili, l'accuratezza è del 96% (o una probabilità del .96). Una bassa accuratezza indica che questo nome è probabilmente usato da entrambi i sessi e non può essere coniugato a un genere specifico.

Question 2

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

Accepted Answer

Mentre il nome Andrea è maschile in Italia, in Germania Andrea è un nome femminile e può addirittura essere usato sia per maschi che per femmine negli Stati Uniti. 
In questo caso, forniamo un valore di accuratezza nel risultato della query, variabile tra 0 e 100 (o un valore di probabilità tra 0 e 1).
Questo valore ti indica quanto siamo certi di aver rilevato il genere corretto.
Puoi aumentare significativamente la qualità dei risultati dell'API fornendo informazioni geografiche sulla tua query. Questo può essere un
codice paese, la lingua del browser o un indirizzo IP. Puoi approfondire l'argomento della localizzazione della query nelle nostre documentazioni sull'API

Question 3

Come raccogliete i dati?

Accepted Answer

Per fornire la massima precisione 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 registri 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 faciliti 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 precisione?

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 evenienza in cui il nostro servizio non soddisfi le vostre aspettative, vi offriamo una semplice garanzia di rimborso del denaro entro 14 giorni.
Naturalmente, offriamo anche la possibilità di testare completamente gratuitamente il nostro servizio. Se vi iscrivete qui, riceverete 100richieste gratuite ogni mese.
Se effettuate una query su un nome, i nostri endpoint restituiranno nella risposta un valore di accuratezza o di probabilità, a seconda della versione dell'API utilizzata.
Il parametro di accuratezza restituisce quanto siamo sicuri che questo nome sia maschile o femminile. 
Il valore è calcolato in base al numero di registrazioni presenti nel nostro database. 
Dato che i casi d'uso differiscono notevolmente, non forniamo alcuna raccomandazione sul livello di accuratezza. A seconda del vostro caso d'uso, spetta a voi decidere quali risultati accettare e a quali livelli di accuratezza.
Anche con una precisione di almeno il 99%, c'è la possibilità che il risultato sia incorretto.
Tuttavia, un valore superiore al 95% si adatta alla maggior parte dei casi d'uso in generale

Question 8

Quanti nomi hai memorizzato nel tuo database?

Accepted Answer

Il nostro database contiene 6,084,389 nomi validati da 191 paesi diversi. In tutto il mondo conserviamo 6,196,452 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

Supporti i nomi arabi?

Accepted Answer

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

Question 11

Posso interrogare più nomi in una sola richiesta?

Accepted Answer

Sì, questo è assolutamente possibile. Puoi interrogare fino a 100 nomi contemporaneamente.
                        Per i dettagli, consulta i nostri API Docs.

Question 12

Ho sentito parlare della tua API di posta elettronica. Cosa è esattamente?

Accepted Answer

La nostra API per email può estrarre i nomi dagli indirizzi email e fornire il genere appropriato per questo indirizzo. Questo può aiutarti a personalizzare le tue email con un saluto adeguato. Ad esempio, dall'indirizzo email "marie.johnson@gmail.com", l'API estrarrà il nome "Marie" e determinerà il genere corretto, che è "femminile". Per maggiori 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 opzionalmente aggiungere una colonna di paese al tuo dataset. Non è necessario specificare i nomi delle colonne, il nostro assistente ti guida nel processo consentendoti di scegliere quale colonna contiene quale token, ovvero il nome o il paese incluso. La funzione si trova all'interno del tuo account. I record elaborati saranno addebitati come richieste in modo da poter caricare un file CSV con fino a 100 inserimenti gratuitamente ogni mese. Il caricamento di massa CSV richiede un account su Gender-API.com. Per motivi di protezione dei dati, i file caricati verranno automaticamente eliminati dopo un anno.

Question 14

Come deve essere formattato il file CSV?

Accepted Answer

Supportiamo i file CSV creati su Windows, MacOS o Linux. 
        Inoltre, supportiamo i file con delimitatori come ";", "," o una tabulazione. Il carattere di racchiudimento deve essere un ". 
        Inoltre, puoi caricare file CSV multilinea con un massimo di 10.000.000 righe e 301MB. 
        Consigliamo di utilizzare un file CSV formattato in UTF-8 con un punto e virgola come delimitatore per ottenere i migliori risultati possibili. 
        In caso contrario, il file CSV può contenere ulteriori righe arbitrarie, che saranno incluse anche nel file di output. 
        Il file deve avere almeno una colonna con solo nomi o una colonna con nomi completi.
        Clicca qui per scaricare un file di esempio. Per favore crea un account su 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, si prega di utilizzare il caricamento di file CSV.
Supportiamo file .xlsx con un singolo foglio. Se carichi un file con più di un foglio, solo il primo verrà elaborato.
La prima riga del foglio deve contenere i nomi delle colonne. Il file deve contenere almeno una colonna con i nomi propri, la colonna del paese è opzionale. Per motivi di protezione dei dati, i file caricati saranno automaticamente eliminati 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. Per favore mandaci una 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 conformi al GDPR.
                Forniamo un Accordo di elaborazione dati (DPA), che vi permette di rispettare i vostri obblighi GDPR.
                Potete richiedere questo accordo quì nel vostro account. Un accordo di esempio può essere scaricato quì.
                Inoltre, potete trovare maggiori informazioni su come proteggiamo i vostri dati quì.

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

Every account will be recharged to 100 requests on the first day of every month if there are less than this number of requests left.
                Only if a result is found, the request will be counted. One name lookup will be counted as one request. 
                If multiple names are requested in one query, each name will be counted as a single request.

Question 20

Dove posso trovare e gestire le mie chiavi API?

Accepted Answer

Generiamo una chiave API iniziale quando ti registri per un account su Gender-API.com. Puoi trovare questa chiave API nella parte inferiore della pagina di panoramica del tuo account. Se vuoi revocare questa chiave, clicca sul pulsante "Revoca e Rigenera".
Il nostro sistema invaliderà la chiave API esistente e ne genererà una nuova. Tutte le tue applicazioni che utilizzano il vecchio token non saranno in grado di accedere alla nostra API fino a quando non sostituirai questo codice con la nuova chiave API. [immagineChiaveApi]
Puoi anche creare più di una chiave API. Questo è utile, ad esempio, se hai più applicazioni in cui desideri includere la nostra API. Si prega di notare che non esiste distinzione tra le chiavi e quanti richieste sono state effettuate. Tutte le richieste sono contate in modo collettivo. Per gestire o creare più chiavi API, clicca sul pulsante "Impostazioni" nel menu dell'account e poi su "Chiavi API". 
        [immagineChiaviMultiple] Cliccando sul pulsante "Crea Nuova Chiave", puoi generare una nuova chiave API. Puoi dare un nome a ciascun token per identificare più facilmente dove questa chiave è stata utilizzata. Puoi cambiare questo nome in qualsiasi momento. Inoltre, alcuni dei nostri widget genereranno automaticamente una chiave qui. Ad esempio, se utilizzi il nostro "Quick Lookup Widget" nel tuo account, il nostro sistema genererà in anticipo una chiave, e questo widget utilizzerà poi questo token per interrogare la nostra API.
        Inoltre, le app di terze parti creeranno una chiave qui una volta connesse. Ogni token può essere revocato in qualsiasi momento semplicemente cliccando sulla "x". Una volta revocata, 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 persone collegate al tuo progetto nel tuo account. Per gestire il tuo team, accedi al tuo account e, nel menu dell'account, fai clic su "Impostazioni" => "Gestisci Il Tuo Team". In questa pagina, fai clic sul pulsante "Invita un nuovo membro" per invitare per e-mail persone al tuo team. Quando invii l'invito, puoi scegliere tra due diversi tipi di account. 
        A) Gli utenti possono visualizzare, creare, aggiornare ed eliminare le chiavi API, caricare file CSV ed Excel e determinare il loro genere, accedere a tutti i punti finali delle API, acquistare richieste e connettersi ad app di terze parti. B) Gli amministratori possono fare la stessa roba degli utenti, oltre a
        aggiornare le impostazioni dell'account e l'indirizzo di fatturazione, creare e visualizzare accordi di elaborazione dati, 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 abilitando la verifica in due passaggi. Per abilitare questa misura di sicurezza aggiuntiva, accedi al tuo account e nel menu dell'account, clicca su "Impostazioni" => "Cambia Password / 2FA". Assicurati di avere un'applicazione autenticatore installata sul tuo telefono. Consigliamo di utilizzare un'app come Authy (iOS, Android) o Google Authenticator (iOS, Android).
Clicca poi sul pulsante "Abilita ora" e segui le istruzioni a schermo. Puoi aggiungere qui più dispositivi per garantire, ad esempio, di avere ancora accesso al tuo account dopo la perdita di un dispositivo.
Una volta abilitato, ti verrà richiesto di inserire il codice generato dall'app autenticatore del tuo telefono per effettuare correttamente l'accesso.

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

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

Accepted Answer

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

Question 25

Come posso effettuare il logout da tutti i dispositivi?

Accepted Answer

Se clicchi sul pulsante di logout nel tuo account, verrai solo disconnesso dal dispositivo corrente. 
Per garantire la sicurezza del tuo account e dei dati, è importante uscire da tutti i dispositivi quando necessario. Si prega di seguire le istruzioni di seguito per uscire con successo da tutti i dispositivi sulla nostra piattaforma API.
Quando sei connesso, clicca qui per uscire da tutti i dispositivi. Inoltre, se cambi la tua password o modifichi le impostazioni dell'autenticazione a due fattori, il sistema ti disconnetterà automaticamente da tutti i dispositivi che non corrispondono al tuo attuale indirizzo IP. Ciò aggiunge un ulteriore livello di sicurezza al tuo account. Si consiglia di creare account separati per ogni membro del team al fine di migliorare la sicurezza e facilitare la collaborazione tra team.
Inoltre, per migliorare la sicurezza del tuo account, è fortemente consigliato di abilitare l'autenticazione a due fattori (2FA). Questo ulteriore strato di protezione aggiunge un passaggio extra al processo di accesso, rendendolo più difficile per individui non autorizzati di accedere.

Question 26

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

Accepted Answer

Se desideri acquistare uno dei nostri pacchetti, puoi scegliere tra un pagamento una tantum o l'iscrizione a questo pacchetto.
 Le iscrizioni sono consigliate se si desidera utilizzare il nostro servizio regolarmente. Puoi essere certo che ci siano sempre abbastanza richieste rimanenti nel tuo account.
 Le richieste acquistate con una sottoscrizione possono essere utilizzate entro un mese. Con una sottoscrizione attiva, il nostro sistema ricaricherà il tuo account dopo un mese 
 all'importo selezionato di richieste. Ad esempio, se sei iscritto al nostro pacchetto di 25.000 richieste e ne hai utilizzate 21.500, 
 il nostro sistema ricaricherà il tuo account con 25.000 richieste dopo un mese.
 I pacchetti per pagamento una tantum possono essere acquistati per un singolo caso d'uso e possono essere utilizzati entro un anno. Ad esempio, se si desidera elaborare un file Excel o CSV, si consiglia l'acquisto una tantum.
 Gli acquisti per pagamento una tantum non si rinnovano. Devi assicurarti di non esaurire le richieste.
 È possibile passare tra entrambi i tipi di pacchetti sulla nostra pagina di acquisto.

 [difference]
Per favore non confondere entrambi i tipi di acquisto fino a quando non hai parlato con il nostro supporto o sai esattamente cosa stai facendo. L'acquisto di un pacchetto una tantum mentre sei iscritto a uno dei nostri pacchetti può impedire alla sottoscrizione di riempire le tue richieste. Ad esempio, quando ci sono più richieste rimaste dall'acquisto una tantum, rispetto a quanto la sottoscrizione dovrebbe ricaricare.

Question 27

Ho bisogno di un certificato di residenza. È possibile emettere tale certificato?

Accepted Answer

Se hai bisogno di un certificato di residenza dalla nostra azienda, contatta il nostro supporto per la tua richiesta. Il certificato deve essere richiesto singolarmente per ogni azienda. Nel tuo messaggio spiega l'indirizzo completo della tua azienda, il tuo paese di residenza, e, se possibile, il tuo numero di contribuente. 

Il certificato di residenza deve essere firmato dal nostro ufficio delle entrate. Di solito ci vogliono 2-3 settimane per ricevere il modulo firmato, che possiamo poi fornire come scansione digitale.

[certificate-of-residence]

Question 28

Come posso acquistare un pacchetto / richiedere ulteriori richieste?

Accepted Answer

Puoi scegliere tra un piano di abbonamento o un pagamento una tantum here.
Il pagamento una tantum è consigliato se desideri elaborare un grande file CSV o se preferisci utilizzare le tue richieste in modo irregolare.
Puoi ricaricare il tuo account con l'importo richiesto di richieste in qualsiasi momento. Le richieste acquistate con il pagamento una tantum possono essere utilizzate entro un anno.
Se preferisci iscriverti a un piano di abbonamento, il tuo account verrà ricaricato con il numero selezionato di richieste ogni mese.
Gli abbonamenti possono essere modificati o cancellati in qualsiasi momento.

Question 29

Come posso cancellare la mia sottoscrizione?

Accepted Answer

Puoi modificare o cancellare la tua sottoscrizione in qualsiasi momento qui. Se vuoi interrompere i pagamenti ricorrenti, clicca sul pulsante "Annulla questa sottoscrizione".

Question 30

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 31

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 all’ora e 500 richieste al giorno. Gli account a pagamento hanno limiti più alti:  
1500 richieste al minuto e nessuna limitazione giornaliera finché hai crediti disponibili.  
Se hai bisogno di limiti più alti per il tuo caso d’uso specifico, ti preghiamo di contact us per discutere un piano personalizzato.  
Le richieste batch (fino a 100 nomi per richiesta) contano come singole richieste ma sono più efficienti.

Question 32

Qual è la garanzia di uptime della tua API?

Accepted Answer

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

Question 33

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 34

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 35

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 una precisione 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 36

Come gestite le variazioni dei nomi e i soprannomi?

Accepted Answer

Il nostro database include variazioni comuni dei nomi, diminutivi e soprannomi. Ad esempio,  
        "Bob" è riconosciuto come una variante di "Robert" e "Liz" come una variante di "Elizabeth". Tuttavia, ti consigliamo  
        di interrogare il nome completo quando è disponibile, per ottenere la massima accuratezza. I nostri sistemi di IA imparano continuamente nuove variazioni di nomi  
        dal nostro dataset. Se trovi un soprannome che non viene riconosciuto, ti preghiamo di let us know e lo aggiungeremo  
        al nostro database. Le variazioni regionali (come "Juan" vs "John") sono gestite tramite i nostri dataset specifici per paese.

Question 37

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 38

Quali fonti di dati usi?

Accepted Answer

Combiniamo più fonti di dati autorevoli per garantire la massima accuratezza. Queste includono: dati dei censimenti governativi e registri di nascita di numerosi paesi, database pubblicamente disponibili dei nomi, social media e reti professionali (anonimizzati e conformi al GDPR), archivi storici dei nomi e verifiche manuali effettuate dal nostro team di data. Tutte le fonti di dati sono accuratamente verificate e incrociate. Diamo priorità alle fonti governative ufficiali quando disponibili. I nostri modelli di IA aiutano anche a identificare schemi e a verificare la coerenza tra le diverse fonti. Un elenco completo dei paesi supportati è disponibile qui. Aggiorniamo regolarmente il nostro database man mano che diventano disponibili nuovi dati ufficiali.

Question 39

Come garantite la privacy e la protezione dei dati?

Accepted Answer

Prendiamo la privacy molto seriamente e rispettiamo il GDPR, il CCPA e altre normative internazionali sulla protezione dei dati. Non memorizziamo i nomi che richiedi oltre a quanto necessario per il logging del funzionamento del servizio. Tutte le comunicazioni API sono crittografate tramite HTTPS/TLS. Offriamo Data Processing Agreements per 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 la nostra completa privacy policy per tutti i dettagli. Controlli di sicurezza periodici garantiscono la conformità continua.

Question 40

Posso ricevere fatture e ricevute per i miei pagamenti?

Accepted Answer

Sì, le fatture vengono generate automaticamente per tutti gli acquisti e sono disponibili nella tua account dashboard. Puoi scaricare le fatture in PDF in qualsiasi momento e vengono anche inviate al tuo indirizzo email registrato.  
Le fatture includono tutti i dettagli necessari a fini contabili, inclusi i dati IVA ove applicabile.  
Puoi aggiornare in qualsiasi momento le informazioni di fatturazione e i dati della tua azienda per assicurarti che le fatture riportino le informazioni corrette.  
Per le fatture passate o per richieste di fatture personalizzate, ti preghiamo di contact support.

Question 41

Qual è la vostra politica di rimborso?

Accepted Answer

Offriamo una semplice garanzia di rimborso di 14 giorni per i primi acquisti.  
Se il nostro servizio non soddisfa le tue aspettative entro i 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 inutilizzati degli acquisti una tantum restano validi per un anno. Forniamo anche rimborsi per problemi tecnici o malfunzionamenti del servizio, valutati caso per caso.  
Ti invitiamo a leggere la nostra politica di cancellazione completa per i dettagli oppure a contattare l’assistenza per qualsiasi domanda.

Question 42

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.

FREQUENTLY ASKED QUESTIONS