Question 1

Wat gebeurt er als een naam zowel door mannen als vrouwen wordt gebruikt?

Accepted Answer

Afhankelijk van uw API-versie of de integratie die u gebruikt, retourneren onze endpoints een precisie- of waarschijnlijkheidswaarde in de respons. De precisieparameter geeft aan hoe zeker we zijn dat deze naam mannelijk of vrouwelijk is. De waarde wordt berekend aan de hand van het aantal records in onze database. Als we bijvoorbeeld 100 monsters van een naam hebben, zijn er 96 vrouwelijk en 4 mannelijk, dan is de precisie 96% (of een waarschijnlijkheid van .96). Een lage precisie geeft aan dat deze naam waarschijnlijk door meerdere genders wordt gebruikt en niet aan een specifiek geslacht kan worden gekoppeld.

Question 2

Kunnen er verschillen zijn voor dezelfde naam per land?

Accepted Answer

Terwijl de naam Andrea in Italië een jongensnaam is, is het een meisjesnaam in Duitsland en kan het zelfs beide zijn in de VS. In dit geval geven we een nauwkeurigheidswaarde in de queryresultaten, variërend van 0 tot 100 (of een waarschijnlijkheidswaarde tussen 0 en 1). Het vertelt je hoe zeker we zijn dat we het juiste geslacht hebben gedetecteerd. Je kunt de resultaten van de API significant verbeteren door geografische informatie over je query te verstrekken. Dit kan een landcode, de taalinstelling van de browser of een IP-adres zijn. Meer informatie over het lokaliseren van een query vind je in onze API-documentatie

Question 3

Hoe verzamel je de gegevens?

Accepted Answer

Om de hoogst mogelijke nauwkeurigheid te verschaffen, combineren we gegevens uit verschillende bronnen. De belangrijkste bronnen voor nieuwe records zijn openbare gegevens, overheidsgegevens en handmatige toevoegingen/correcties. Op basis van de bron van een nieuwe naam, kan het nodig zijn om de naam te verifiëren door middel van een tweede bron voordat deze aan onze lijst wordt toegevoegd. 
        Als we bijvoorbeeld een naam toevoegen op basis van openbare gegevens, kan deze naam een tweede verificatie nodig hebben, zoals een handmatige bevestiging, voordat deze definitief aan onze database wordt toegevoegd.  
        U vindt een lijst van ondersteunde landen hier.

Question 4

Hoe vaak update je de naamgegevens?

Accepted Answer

We werken regelmatig onze gegevens bij, afhankelijk van het land en de beschikbare openbare gegevens. De meeste westerse landen worden elk jaar bijgewerkt. Ook kan de verdeling van namen over geslachten in de loop der jaren veranderen. Als een naam bijvoorbeeld exclusief door vrouwen werd gebruikt in de jaren zeventig, kan het decennia later voornamelijk worden gebruikt door mannelijke mensen. Daarom gebruiken we ook geboortegegevens voor verschillende landen, zoals de VS, om de resultaten te verrijken. Onze modellen proberen al deze factoren zo goed mogelijk in aanmerking te nemen. De geretourneerde nauwkeurigheidswaarde wordt regelmatig aangepast om de werkelijke gebruik in de bevolking zo nauwkeurig mogelijk weer te geven. De waarde moet een redelijke evaluatie bieden op basis van de laatste decennia en kan een mogelijke fluctuatie aangeven. We kijken naar ongeveer de laatste 4 decennia van de gegevens. Als u een zoekopdracht uitvoert en dezelfde zoekopdracht een jaar later herhaalt, kan het zijn dat u een ander resultaat krijgt omdat ons systeem oude gegevens kan hebben verwijderd en nieuwe gegevens kunnen zijn toegevoegd. Elke keer dat er nieuwe gegevens worden toegevoegd, voeren we zogenaamde integratietests uit achteraf. In dit proces wordt onze API getest tegen een eerder gevalideerde dataset om de kwaliteit te waarborgen. Deze dataset wordt voortdurend uitgebreid met namen en testgevallen om de breedst mogelijke dekking te bereiken.

Question 5

Hoe faciliteer je AI?

Accepted Answer

Kunstmatige intelligentie (AI) wordt dagelijks gebruikt om de kwaliteit van onze database en API resultaten te verbeteren. Met behulp van AI kunnen we efficiënt en nauwkeurig nieuwe vermeldingen aan onze database toevoegen, zodat onze informatie altijd up-to-date is.

Bovendien speelt AI ook een cruciale rol bij het verbeteren van de algehele kwaliteit van onze API-resultaten. Door gebruik te maken van machine learning algoritmes kunnen we data effectiever analyseren, patronen identificeren en meer nauwkeurige en relevante resultaten aan onze gebruikers bieden.

Question 6

Bied je hulp aan bij het implementeren van de API?

Accepted Answer

Ja, we bieden e-mailsupport voor alle klanten. Je kan ons bereiken via e-mail op contact gender-api.com. We zullen dan zo snel mogelijk antwoorden. Je kan ook programmeervoorbeelden vinden hier. Houd er rekening mee dat we je niet kunnen helpen met elke programmeertaal en elke use case. In de meeste gevallen kan je een standaard REST-client gebruiken in je app om onze API te bevragen. Veel libraries ondersteunen ook het importeren van een OpenAPI-definitiebestand. Je kan ons openapi.yml definitiebestand downloaden hier.

Question 7

Wat als we een hoog nauwkeurigheidsniveau nodig hebben?

Accepted Answer

Talen en namen zijn veranderlijk en veranderen met de tijd. Van klant tot klant variëren datasets ook sterk in kwaliteit, omvang en herkomst. Daarom kunnen wij niet garanderen dat alle resultaten die je ontvangt van onze API 100% correct zijn en overeenkomen met jouw datapool. Maar we beloven wel dat we ons altijd inzetten om je de best mogelijke resultaten te bieden en dat we regelmatig onze algoritmes verbeteren en updaten. We voegen ook regelmatig nieuwe gegevens toe. Meer informatie over onze updates kun je hier vinden. In het geval dat onze service onverhoopt niet aan je verwachtingen voldoet, bieden wij je een rechttoe rechtaan 14-dagen geld-terug-garantie. 
         Natuurlijk bieden we ook de mogelijkheid om onze service volledig gratis te testen. Als je je hier aanmeldt, ontvang je 100gratis verzoeken per maand. 
         Wanneer je een naam opvraagt, retourneren onze eindpunten een nauwkeurigheids- of een waarschijnlijkheidswaarde in de respons, afhankelijk van jouw API-versie. 
         De nauwkeurigheidsparameter geeft aan hoe zeker we zijn dat deze naam mannelijk of vrouwelijk is. De waarde wordt berekend aan de hand van het aantal vermeldingen dat we in onze database hebben.
         Aangezien gebruiksscenario's aanzienlijk verschillen, geven we geen aanbevelingen over het nauwkeurigheidsniveau. Afhankelijk van jouw gebruiksscenario is het aan jou om te beslissen welke resultaten en nauwkeurigheidsniveaus je accepteert. 
         Zelfs bij een nauwkeurigheid van ten minste 99% bestaat de mogelijkheid dat het resultaat onjuist is.
        Een waarde boven de 95% past echter bij de meeste gebruiksscenario's in het algemeen

Question 8

Hoeveel namen heb je opgeslagen in je database?

Accepted Answer

Onze database bevat 6,084,389 gevalideerde namen uit 191 verschillende landen. Over de hele wereld slaan we 6,196,452 unieke namen op. Gemiddeld analyseren we ongeveer 10.000.000 datasets per maand om de kwaliteit van onze resultaten te verbeteren.

Question 9

Welke landen worden ondersteund?

Accepted Answer

De API ondersteunt volledig 191 landen. Volledige ondersteuning betekent dat we ten minste  namen hebben verzameld
in dit respectievelijke land. In de meeste landen is onze dataset echter veel groter. Bekijk de volgende tabel om meer te weten te komen over hoeveel namen we ondersteunen in welk land. Houd er rekening mee dat als we zelf geen geschikte ondersteuning bieden voor een land, u nog steeds de gevraagde namen kunt crawlen tegen de hele dataset om een ​​adequaat resultaat te krijgen.

Question 10

Ondersteunt u Arabische namen?

Accepted Answer

Ja, onze API ondersteunt Arabische namen. Deze kunnen ook geschreven worden met karakters uit het Arabische alfabet. 
Arabisch wordt geschreven van rechts naar links in cursief en bevat 28 letters.
Als voorbeeld, als je "عبد ال" opvraagt, krijg je het volgende resultaat: "gender": "male", "accuracy": 100.
In dit voorbeeld is de Arabische naam "عبد ال" geurlencodeerd en zou de query-URL er zo uitzien: https://gender-api.com/get?name=%D8%B9%D8%A8%D8%AF%20%D8%A7%D9%84&key=YOUR_API_KEY.
Je kunt hier een volledige lijst met ondersteunde landen vinden

Question 11

Kan ik meerdere namen in één verzoek opvragen?

Accepted Answer

Ja, dit is absoluut mogelijk. Je kunt maximaal 100 namen tegelijk opvragen. 
                         Voor meer informatie, kijk alsjeblieft naar onze API-documentatie.

Question 12

Ik heb gehoord over jullie e-mail API. Wat is dat juist?

Accepted Answer

Onze e-mail API kan namen uit e-mailadressen halen en het bijbehorende geslacht bepalen. Met deze informatie kunt u uw e-mails personaliseren met een juiste aanhef. Bijvoorbeeld, uit het e-mailadres "marie.johnson@gmail.com" zal de API de naam "Marie" halen en het juiste geslacht bepalen, wat "vrouwelijk" is. Voor meer details kunt u een kijkje nemen in onze API-documentatie.

Question 13

Ik heb een grote hoeveelheid data. Kan ik een CSV-bestand in bulk uploaden?

Accepted Answer

Als geregistreerde gebruiker kun je elk CSV-bestand met een voornaamkolom uploaden. Voor een beter bepalingsresultaat kun je optioneel een landkolom aan je dataset toevoegen. Hoewel het niet nodig is om de kolommen specifiek te benoemen, begeleidt onze assistent je door je te laten kiezen welke kolom elk token bevat, voornaam of land inbegrepen. 
De functie bevindt zich binnen jouw account. Verwerkte records worden zoals verzoeken in rekening gebracht, zodat je elke maand gratis een CSV-bestand met maximaal 100 vermeldingen kunt uploaden. De CSV-bulkupload vereist een Gender-API.com account. Om redenen van gegevensbescherming worden geüploade bestanden automatisch na één jaar verwijderd.

Question 14

Hoe moet het CSV-bestand worden opgemaakt?

Accepted Answer

We ondersteunen CSV-bestanden die zijn aangemaakt op Windows, MacOS of Linux. 
Bovendien ondersteunen we bestanden met scheidingstekens zoals ";", "," of een tab. Het afsluitingskarakter moet een "." zijn. 
Bovendien kunt u multi-line CSV-bestanden uploaden met maximaal 10.000.000 rijen en 301MB. 
We raden aan om een CSV-bestand te gebruiken met een UTF-8-indeling en een puntkomma als scheidingsteken, om de best mogelijke resultaten te behalen. 
Anders kan het CSV-bestand verdere, willekeurige rijen bevatten, die ook in het uitvoerbestand worden opgenomen. 
Het bestand moet ten minste één kolom bevatten met alleen voornamen of een kolom met volledige namen. 
Klik hier om een voorbeeldbestand te downloaden. Maak een Gender-API.com-account aan om een CSV-bestand te uploaden.

Question 15

Kan ik een Excel-bestand uploaden?

Accepted Answer

Je kunt Excel-bestanden uploaden met maximaal 300.000 rijen. Voor grotere datasets kun je gebruik maken van onze CSV-bestandsupload.
        We ondersteunen .xlsx-bestanden met één werkblad. Als je een bestand uploadt met meer dan één werkblad, wordt alleen de eerste verwerkt.
        De eerste rij van je werkblad moet de kolomnamen bevatten. Het bestand moet ten minste één kolom met voornamen bevatten, de kolom voor het land is optioneel. Om redenen van gegevensbescherming worden geüploade bestanden automatisch na één jaar verwijderd. Download het voorbeeldbestand hier. Voorbeeld:

Question 16

Ik heb een bug gevonden. Wat moet ik doen?

Accepted Answer

We waarderen uw hulp zeer. Stuur ons alstublieft een e-mail naar contact gender-api.com en we zullen proberen dit probleem zo snel mogelijk op te lossen.

Question 17

Voldoet Gender-API aan de Algemene Verordening Gegevensbescherming (AVG / GDPR)?

Accepted Answer

Alle diensten van Gender-API.com voldoen volledig aan de GDPR.
We bieden een Data Processing Agreement (DPA) aan, waarmee je kunt voldoen aan je GDPR verplichtingen.
Je kunt dit contract hier aanvragen in je account. Een voorbeeldcontract kan hier worden gedownload.
Ook kun je hier hier meer informatie vinden over hoe wij jouw gegevens beschermen.

Question 18

Bieden jullie bibliotheken aan voor programmeertalen?

Accepted Answer

Vanwege de eenvoud van onze API bieden we geen bibliotheek aan voor welke programmeertaal dan ook, behalve de jQuery-plugin. De meeste talen ondersteunen een json-parser out-of-the-box en voor bijna elke andere taal is er al een externe bibliotheek beschikbaar die je kunt gebruiken. Bekijk onze codevoorbeelden om aan de slag te gaan met het gebruik van de API:

Question 19

Hoe worden verzoeken geteld?

Accepted Answer

Elke account zal worden bijgevuld met 100 aanvragen op de eerste dag van elke maand, als er minder dan dit aantal aanvragen over is. Alleen als er een resultaat wordt gevonden, wordt de aanvraag geteld. Eén naamzoeking telt als één aanvraag. Als er meerdere namen worden aangevraagd in één zoekopdracht, dan wordt elke naam als één aanvraag geteld.

Question 20

Waar kan ik mijn API-sleutels vinden en beheren?

Accepted Answer

We genereren een eerste API-sleutel wanneer je een Gender-API.com-account aanmaakt. Je kunt deze API-sleutel onderaan je accountoverzichtspagina vinden. Als je deze sleutel wilt intrekken, klik dan op de knop "Intrekken en opnieuw genereren". 
        Ons systeem zal vervolgens de bestaande API-sleutel ongeldig maken en een nieuwe genereren. Al je toepassingen die de oude token gebruiken, hebben geen toegang meer tot onze API totdat je deze code vervangt door de nieuwe API-sleutel. [apiKeyImage] 
        Je kunt ook meer dan één API-sleutel creëren. Dit is handig, bijvoorbeeld als je meerdere toepassingen hebt waarin je onze API wilt opnemen. Let op, er is geen onderscheid tussen de sleutels en hoeveel verzoeken er zijn gebruikt. Alle verzoeken worden samen geteld. Om meerdere API-sleutels te beheren of te maken, klik op de knop "Instellingen" in het accountmenu, en vervolgens op "API-sleutels". 
        [multipleKeysImage] Door te klikken op de knop "Nieuwe sleutel aanmaken", kunt u een nieuwe API-sleutel genereren. U kunt elke token een naam geven om later gemakkelijker te identificeren waar deze sleutel is gebruikt. U kunt deze naam op elk moment wijzigen. Bovendien zal onze systeem sommige van onze widgets hier automatisch een sleutel genereren. Als u bijvoorbeeld onze "Quick Lookup Widget" in uw account gebruikt, zal ons systeem van tevoren een sleutel genereren, en deze widget zal vervolgens deze token gebruiken om onze API op te vragen.
        Bovendien zal er hier door derde partijen apps een sleutel worden aangemaakt zodra ze zijn verbonden. Elke token kan op elk moment worden ingetrokken door eenvoudig op de "x" te klikken. Zodra ingetrokken, zal de verbonden applicatie geen toegang meer hebben tot onze API.

Question 21

Kan ik mijn account delen met meerdere personen?

Accepted Answer

Je kunt je account met nog eens 50 collega's of andere mensen die verbonden zijn aan jouw project in je account delen. Om je team te beheren, log je in op je account en klik je in het accountmenu op "Instellingen" => "Jouw Team Beheren". Op deze pagina klik je op de knop "Een nieuw lid uitnodigen" om mensen via e-mail uit te nodigen voor je team. Bij het uitnodigen van leden kun je kiezen tussen twee verschillende accounttypen. 
    A) Gebruikers kunnen API-sleutels bekijken, maken, bijwerken en verwijderen, CSV- en Excel-bestanden uploaden en deze genderiseren, toegang krijgen tot alle API-eindpunten, verzoeken kopen en third-party apps aansluiten. B) Beheerders kunnen hetzelfde doen als gebruikers, plus accountinstellingen en factuuradressen bijwerken, gegevensverwerkingsovereenkomsten maken en bekijken, teamleden uitnodigen, bijwerken en verwijderen.

Question 22

Kan ik mijn account beschermen door tweestapsverificatie in te schakelen?

Accepted Answer

Je kunt je account beschermen door tweestapsverificatie in te schakelen. Om deze extra beveiligingsmaatregel in te schakelen, log je in op je account en klik je in het menu op "Instellingen" => "Wachtwoord wijzigen/2FA". Zorg ervoor dat je een authenticator-app op je telefoon hebt geïnstalleerd. We raden aan een app zoals Authy (App Store, Play Store) of Google Authenticator (App Store, Play Store) te gebruiken. 
Klik vervolgens op de knop "Nu inschakelen" en volg de instructies op het scherm. Je kunt hier meerdere apparaten toevoegen om er bijvoorbeeld voor te zorgen dat je nog steeds toegang hebt tot je account nadat je een apparaat bent verloren.
Nadat tweestapsverificatie is ingeschakeld, moet je de gegenereerde code van de authenticator-app op je telefoon invoeren om succesvol in te loggen.

Question 23

Kan ik externe apps gebruiken wanneer tweestapsverificatie is ingeschakeld?

Accepted Answer

Sommige integraties of third-party apps werken perfect met tweestapsverificatie ingeschakeld. Anderen vereisen misschien dat je inlogt zonder tweestapsverificatie. Als je problemen hebt om in te loggen bij een app met jouw Gender-API.com-gegevens, log dan rechtstreeks in op jouw account op Gender-API en klik op "Instellingen" => "Wachtwoord wijzigen / 2FA" in het accountmenu. Klik vervolgens op het "Two-Step Verification" tabblad en stel "Toegang door derden" in op "Niet beperkt". Houd er rekening mee dat je deze instelling alleen kunt wijzigen als tweestapsverificatie is ingeschakeld.

Question 24

Wat is het verschil tussen een betaald en gratis account?

Accepted Answer

Beide accounttypes bieden dezelfde functionaliteit. Alle API-eindpunten zijn beschikbaar voor beide accounttypes en geven dezelfde resultaten terug. 
        Gratis accounts zijn beperkt tot een bepaald aantal verzoeken per maand. Bij aanmelding zijn 100 verzoeken onmiddellijk gratis beschikbaar. Op de eerste dag van elke maand zal ons systeem dit aantal resetten, 
        en de gratis verzoeken zullen weer beschikbaar zijn. Maak alstublieft slechts één account aan. Als u meer verzoeken nodig heeft, kunt u op elk moment upgraden naar een van onze betaalde plannen hier.

Question 25

Hoe kan ik uitloggen op alle apparaten?

Accepted Answer

Als je op de uitlog knop in je account klikt, zal je alleen uitgelogd worden van het huidige apparaat.
                Om de veiligheid van je account en data te waarborgen, is het belangrijk om uit te loggen van alle apparaten indien nodig. Volg onderstaande instructies om succesvol uit te loggen van alle apparaten op ons API-platform.
                Klik hier here als je bent ingelogd om uit te loggen van alle apparaten. Als je je wachtwoord wijzigt of je instellingen voor tweefactorauthenticatie aanpast, 
                zal het systeem je automatisch uitloggen van alle apparaten die niet overeenkomen met je huidige IP-adres. Dit voegt een extra laag van veiligheid toe aan je account. Het is aanbevolen om aparte accounts voor elk
                teamlid aan te maken om de veiligheid te verhogen en team samenwerking te bevorderen.
                Verder raden wij sterk aan om Tweefactorauthenticatie (2FA) in te schakelen om de veiligheid van je account te verhogen. Deze extra laag van bescherming voegt een extra stap toe aan het inlogproces, waardoor het moeilijker wordt voor ongeautoriseerde personen om toegang te krijgen.

Question 26

Wat is het verschil tussen een abonnement en een eenmalige betaling?

Accepted Answer

Als je een van onze pakketten wilt kopen, kun je kiezen tussen een eenmalige betaling of een abonnement op dit pakket.
Abonnementen worden aanbevolen als je onze service regelmatig wilt gebruiken. Je bent er dan van verzekerd dat er altijd genoeg resterende aanvragen op je account staan.
Aankopen gedaan met een abonnement kunnen binnen een maand worden gebruikt. Met een actief abonnement zal ons systeem na een maand je account opnieuw opladen 
met het geselecteerde aantal aanvragen. Als je bijvoorbeeld geabonneerd bent op ons pakket van 25.000 aanvragen en je hebt er 21.500 gebruikt, 
dan zal ons systeem je account na een maand weer bijvullen met 25.000 aanvragen.
Eenmalige pakketten kunnen worden gekocht voor een enkel gebruik en kunnen binnen een jaar worden gebruikt. Als je bijvoorbeeld een Excel of CSV-bestand wilt verwerken, raden we de eenmalige aankoop aan.
Eenmalige aankopen worden niet verlengd. Je moet ervoor zorgen dat je niet zonder aanvragen komt te zitten.
Je kunt tussen beide pakkettypen schakelen op onze aankoop pagina.

[verschil]
Gelieve beide aankoop typen niet door elkaar te halen totdat je eerst met onze ondersteuning hebt gesproken of precies weet wat je doet. Het kopen van eenmalige pakket terwijl je geabonneerd bent op een van onze pakketten kan ervoor zorgen dat het abonnement jouw verzoeken niet meer vult. Bijvoorbeeld, wanneer er meer verzoeken over zijn van de eenmalige aankoop dan dat het abonnement kan vullen.

Question 27

Ik heb een bewijs van woonplaats nodig. Kun je zo'n bewijs verstrekken?

Accepted Answer

Als u een uittreksel uit het bevolkingsregister nodig heeft van ons bedrijf, neem dan contact op met ons support wat betreft uw verzoek. Het uittreksel dient voor elk bedrijf afzonderlijk te worden aangevraagd. Voeg in uw verzoek het volledige adres van uw bedrijf, uw land van verblijf en, indien beschikbaar, uw belastingnummer toe. 

Het uittreksel uit het bevolkingsregister moet door ons belastingkantoor worden ondertekend. Gewoonlijk duurt het 2-3 weken voordat het ondertekende formulier wordt ontvangen, waarna wij u deze als een digitale scan kunnen verstrekken. 

[certificate-of-residence]

Question 28

Hoe kan ik een pakket/meer verzoeken kopen?

Accepted Answer

Je kunt kiezen tussen een abonnement of een eenmalige betaling here.
        Een eenmalige betaling wordt aanbevolen als je een grote CSV bestand wilt verwerken of als je jouw verzoeken op onregelmatige basis wilt gebruiken.
        Je kunt op elk moment jouw account opladen met het vereiste aantal verzoeken. Verzoeken gekocht met eenmalige betaling kunnen binnen één jaar worden gebruikt.
        Als je liever voor een abonnement wilt inschrijven, wordt jouw account elke maand bijgevuld met het geselecteerde aantal verzoeken.
        Abonnementen kunnen op elk moment worden gewijzigd of geannuleerd.

Question 29

Hoe kan ik mijn abonnement opzeggen?

Accepted Answer

U kunt uw abonnement altijd hier wijzigen of annuleren. Als u uw terugkerende betalingen wilt stoppen, klikt u op de knop "Dit abonnement annuleren".

Question 30

Wat is de typische API-responstijd?

Accepted Answer

Onze API is ontworpen voor hoge prestaties en reageert meestal binnen 10-200 milliseconden.  
De responstijden kunnen licht variëren afhankelijk van je geografische locatie, netwerkcondities en de complexiteit van je query.  
Bij batchverzoeken met meerdere namen schaalt de responstijd lineair. We gebruiken een wereldwijd CDN en geoptimaliseerde infrastructuur om wereldwijd een lage latency te garanderen. Als je consequent trage responstijden ervaart, neem dan contact op met ons ondersteuningsteam.

Question 31

Zijn er limieten of beperkingen op het aantal aanvragen?

Accepted Answer

We hanteren eerlijke gebruikslimieten om een optimale service voor alle gebruikers te garanderen.  
Gratis accounts kunnen tot 100 verzoeken per uur en 500 verzoeken per dag doen. Betaalde accounts hebben hogere limieten:  
1500 verzoeken per minuut en geen dagelijkse beperkingen, zolang je nog credits beschikbaar hebt.  
Als je voor jouw specifieke usecase hogere limieten nodig hebt, neem dan contact met ons op om een aangepast plan te bespreken.  
Batch-verzoeken (tot 100 namen per verzoek) tellen als afzonderlijke verzoeken, maar zijn efficiënter.

Question 32

Wat is jullie uptime-garantie voor de API?

Accepted Answer

We garanderen 99.9% API-uptime op alle betaalde abonnementen. Onze infrastructuur wordt gehost op servers van ondernemingsniveau met automatische failover en load balancing. We bewaken onze systemen continu, 24/7, en hebben geautomatiseerde waarschuwingen voor eventuele problemen.  
We bieden ook een Service Level Agreement (SLA) voor zakelijke klanten. In het zeldzame geval van langdurige uitvaltijd ontvangen betalende klanten automatisch servicecredits op basis van onze SLA-voorwaarden.

Question 33

Welk formaat gebruikt de API-respons?

Accepted Answer

Onze API geeft standaard antwoorden terug in JSON-formaat, dat breed wordt ondersteund door alle moderne programmeertalen. Elk antwoord bevat de opgevraagde naam, het gedetecteerde gender, een nauwkeurigheids-/waarschijnlijkheidswaarde en extra metadata. Bijvoorbeeld: {"name":"Maria","gender":"female","accuracy":99,"samples":12847,"country":"US"}. Je vindt gedetailleerde antwoordschema’s in onze API-documentatie en je kunt onze OpenAPI-specificatie downloaden voor automatische clientgeneratie.

Question 34

Hoe kan ik API-fouten het beste afhandelen?

Accepted Answer

Onze API gebruikt standaard HTTP-statuscodes om succes of fouten aan te geven.  
200 betekent succes, 401 geeft een ongeldige API-sleutel aan, 429 betekent dat de ratelimiet is overschreden en 500 duidt op een serverfout.  
Elke foutrespons bevat een beschrijvende melding en foutcode voor eenvoudig debuggen.  
We raden aan om exponentiële back-off te implementeren voor ratelimit-fouten en geslaagde responses waar mogelijk te cachen.  
Bij aanhoudende fouten kun je onze API documentation raadplegen of contact opnemen met support.  
Alle fouten worden gelogd voor probleemoplossing.

Question 35

Hoe ga je om met API-versies?

Accepted Answer

We onderhouden momenteel twee API-versies: V1 en V2. V2 is onze nieuwste versie met uitgebreide functies, waaronder waarschijnlijkheidswaarden, uitgebreide landondersteuning en verbeterde nauwkeurigheid. V1 blijft beschikbaar voor achterwaartse compatibiliteit, maar we raden je aan om voor nieuwe integraties over te stappen naar V2. Alle API-endpoints bevatten de versie in het URL-pad (bijv. /v2/name). We garanderen dat oudere API-versies blijven werken. Migratiehandleidingen zijn beschikbaar in onze API‑documentatie. Ingrijpende wijzigingen worden altijd ruim van tevoren gecommuniceerd.

Question 36

Hoe gaan jullie om met naamvarianten en bijnamen?

Accepted Answer

Onze database bevat veelvoorkomende naamvarianten, verkortingen en bijnamen. Zo wordt  
„Bob” herkend als een variant van „Robert” en „Liz” als een variant van „Elizabeth”. We raden je echter aan om, wanneer mogelijk, altijd de volledige voornaam op te vragen voor de beste nauwkeurigheid.  

Onze AI‑systemen leren continu nieuwe naamvarianten uit onze dataset. Als je een bijnaam tegenkomt die niet wordt herkend, laat het ons dan weten en we voegen deze toe aan onze database.  

Regionale varianten (zoals „Juan” vs „John”) worden verwerkt via onze landspecifieke datasets.

Question 37

Ondersteunt de API namen met speciale tekens en accenten?

Accepted Answer

Ja! Onze API ondersteunt volledig Unicode-tekens, inclusief letters met accenten (é, ñ, ü),  
umlauts, diakritische tekens en niet-Latijnse schriften (Arabisch, Cyrillisch, Chinees, enz.). Namen moeten in UTF-8  
gecodeerd zijn in je API-verzoeken. Bijvoorbeeld: "François", "José", "Müller" en "Søren" worden allemaal correct verwerkt.  
URL-codering wordt automatisch afgehandeld door de meeste HTTP-clients, maar zorg voor de juiste codering van speciale tekens.  
Onze database bevat namen uit 191 landen en dekt alle grote schriftsystemen. Meer details vind je in onze API-documentatie.

Question 38

Welke gegevensbronnen gebruik je?

Accepted Answer

We combineren meerdere gezaghebbende databronnen om maximale nauwkeurigheid te garanderen. Deze omvatten: 
        gegevens uit volkstellingen van overheden en geboorteakten uit tal van landen, openbaar beschikbare naamdatabanken, 
        sociale media en professionele netwerken (geanonimiseerd en AVG-conform), historische naamgegevens, 
        en handmatige controles door ons datateam. Alle databronnen worden zorgvuldig beoordeeld en gekruist gecontroleerd. 
        Waar mogelijk geven we prioriteit aan officiële overheidsbronnen. Onze AI-modellen helpen ook patronen te herkennen en 
        de consistentie tussen bronnen te verifiëren. Een volledige lijst met ondersteunde landen is hier beschikbaar. 
        We werken onze database regelmatig bij zodra er nieuwe officiële gegevens beschikbaar komen.

Question 39

Hoe waarborg je privacy en gegevensbescherming?

Accepted Answer

We nemen privacy heel serieus en voldoen aan de GDPR, CCPA en andere internationale regels voor gegevensbescherming. We slaan de namen die je opvraagt niet op, behalve voor de noodzakelijke logging om de dienst te kunnen laten werken. Alle API-communicatie is versleuteld via HTTPS/TLS. We bieden Data Processing Agreements aan voor zakelijke klanten. Je geüploade CSV-/Excel-bestanden worden automatisch na één jaar verwijderd. We verkopen of delen klantgegevens nooit met derden. Onze servers staan in beveiligde Europese datacenters. Je kunt ons volledige privacybeleid lezen voor alle details. Regelmatige beveiligingsaudits zorgen voor voortdurende naleving.

Question 40

Kan ik facturen en betalingsbewijzen voor mijn betalingen krijgen?

Accepted Answer

Ja, facturen worden automatisch aangemaakt voor alle aankopen en zijn beschikbaar in je account dashboard. Je kunt op ieder moment pdf-facturen downloaden, en ze worden ook naar je geregistreerde e-mailadres gestuurd. Facturen bevatten alle noodzakelijke gegevens voor de boekhouding, inclusief btw-informatie waar van toepassing. Je kunt je facturatiegegevens en bedrijfsgegevens op ieder moment bijwerken zodat facturen de juiste informatie weergeven. Voor eerdere facturen of speciale factuureisen kun je contact opnemen met support.

Question 41

Wat is jullie restitutiebeleid?

Accepted Answer

We bieden een eenvoudige geld-terug-garantie van 14 dagen voor eerste aankopen.  
Als onze service binnen de eerste 14 dagen niet aan je verwachtingen voldoet, neem dan contact met ons op voor een volledige terugbetaling – zonder vragen te stellen.  
Bij abonnementsbetalingen kun je op elk moment opzeggen om toekomstige kosten te stoppen. Ongebruikte credits van eenmalige aankopen  
blijven één jaar geldig. We bieden ook restituties voor technische problemen of storingen in de service, per geval beoordeeld.  
Lees alsjeblieft ons volledige annuleringsbeleid voor alle details of neem contact op met de ondersteuning als je vragen hebt.

Question 42

Welke integraties van derden zijn beschikbaar?

Accepted Answer

We bieden integraties met populaire platforms en tools, waaronder Zapier, Make (voorheen Integromat),  
        Google Spreadsheets, Microsoft Excel, Salesforce, HubSpot en veel CRM‑systemen. Onze API werkt met elk platform dat  
        REST‑API's of webhooks ondersteunt. We bieden kant‑en‑klare connectors en gedetailleerde integratiehandleidingen voor de belangrijkste platforms.  
        Je kunt ook onze CSV upload feature gebruiken voor eenmalige gegevensverwerking zonder enige integratie.  
        Voor aangepaste integraties of ondersteuning voor een specifiek platform kun je onze documentation raadplegen of contact opnemen met support.

VEELGESTELDE VRAGEN