Wat betekent source in V2?
Het veld source geeft aan welke weg het uiteindelijke resultaat heeft opgeleverd: de zoekopdracht in de opgeslagen dataset, een voorspelling door AI of geen geselecteerde bron. Het is geen verwijzing naar de oorspronkelijke uitgever van een item, geen bewijs van een licentie en geen garantie dat de voorspelling juist is.
Deze handleiding beschrijft het huidige antwoordcontract van V2 en een databaseprofiel dat GenderAPI.io zelf heeft opgesteld. De waarnemingen hieronder zijn inventarismetingen en consistentiecontroles; een gecontroleerde catalogus van de oorspronkelijke bronnen en een onafhankelijke evaluatie van de nauwkeurigheid zijn nog niet gepubliceerd.
| source | Betekenis | Wat het niet aantoont |
|---|---|---|
dataset | Er is een opgeslagen item geselecteerd; bij exact gelijke frequenties kan het geslacht toch onbekend zijn | De oorspronkelijke uitgever, de verzamelmethode, de licentie, de ouderdom van het item of de onafhankelijkheid van de waarnemingen |
ai | Het uiteindelijke antwoord komt van de geconfigureerde voorspellingsweg van AI; gender kan toch null zijn | Een getelde steekproef, een verwijzing naar de dataset of een gekalibreerde nauwkeurigheid van de voorspelling |
none | In de modus die alleen de dataset gebruikt, is voor het uiteindelijke resultaat geen opgeslagen item geselecteerd | Dat de invoer in geen enkele populatie of taal een mogelijke koppeling met een naam heeft |
Databaseprofiel: 26 september 2026
De metadata van de collecties zijn gelezen op 2026-09-26T15:28:18.227Z en de willekeurige steekproeven zijn getrokken op 2026-09-26T15:31:54.045Z. De twee aantallen documenten komen elk afzonderlijk uit de collStats-metadata van MongoDB van de betreffende collectie en niet uit een aparte volledige telling. De algemene collectie bevat items voor namen en de landspecifieke collectie combinaties van naam en land. Tel de twee getallen niet op tot een totaal van unieke namen of unieke personen.
Voor elke collectie heeft MongoDB willekeurig 5.000 documenten geselecteerd en op de databaseserver de geaggregeerde controles hieronder berekend. Het openbare rapport bevat geen namen of ruwe gegevens. Het zijn waarnemingen van GenderAPI.io in de productiedatabase, geen onafhankelijke audit en geen bevroren evaluatiedataset. De controles gaan over de consistentie van de tellers, niet over de nauwkeurigheid van voorspellingen, het aantal unieke personen of namen of de dekking van de API.
| Waarneming | Algemene items | Landspecifieke items |
|---|---|---|
| Collectie | general | country-specific |
| Aantal documenten volgens de metadata | 2.483.220 | 4.080.692 |
| Opgeslagen unieke sleutel | name | name + country |
| Willekeurig geselecteerde documenten | 5.000 | 5.000 |
| Niet-geslaagde numerieke controles in de steekproef | 0 | 0 |
| male + female wijkt af van total in de steekproef | 0 | 0 |
| Gelijke frequenties voor male en female in de steekproef | 124 | 94 |
| Veld updated_at aanwezig in de steekproef | 667 / 5.000 | 741 / 5.000 |
Wat de databasecontroles laten zien
De numerieke controle vereist dat total een positief veilig geheel getal is en dat de frequenties male en female eindig zijn en tussen nul en total liggen. Een aparte controle vergelijkt male + female met total. Alle tellers in de steekproeven zijn door de controles gekomen; dat betekent niet dat elk item in de collecties consistent is of dat een voorspelling juist is.
Gelijke frequenties voor male en female zijn gevonden in 124 items uit de steekproef van de algemene collectie en in 94 items uit de steekproef van de landspecifieke collectie. Het gaat om gelijke opgeslagen frequenties, niet om onafhankelijk geverifieerde dubbelzinnige identiteiten en niet om een aandeel onbekende resultaten van de API. De werkelijke resultaten van de API hangen af van de invoer, de beschikbaarheid van Redis, de selectie van kandidaten en de AI-instellingen.
Een aparte inventarisatie van het veld country in de algemene collectie, uitgevoerd op 2026-09-26T15:33:13.811Z, vond 244 verschillende opgeslagen waarden: 239 in de notatie met twee hoofdletters en 5 in een andere notatie. ISO-conformiteit, de verdeling van items per land en de dekking van ondersteunde landen zijn niet gemeten. Deze getallen zijn niet het aantal ondersteunde landen.
In geen van de steekproeven zijn velden voor bron of licentie aangetroffen. Dat bewijst niet dat herkomstinformatie in elk item of in externe systemen ontbreekt: de aan- of afwezigheid van een veld bewijst niets over de licentie van een bron. Het veld updated_at was in sommige items aanwezig als numerieke waarde, maar de waarden en de betekenis ervan zijn niet gecontroleerd; het zegt niets over de actualiteit van de gegevens of over een updateschema.
V2 voert zoekopdrachten in de dataset uit via Redis. Op 26 september 2026 heeft GenderAPI.io als beheerder van het systeem bevestigd dat MongoDB en Redis dezelfde dataset bevatten. De gelijkwaardigheid berust op die bevestiging: er is geen onafhankelijke vergelijking tussen de twee databases uitgevoerd en die controle moet nog plaatsvinden. De inventaris hierboven beschrijft de opgeslagen items; de dekking van de antwoorden van de API hangt daarnaast af van de verstuurde invoer, de match van kandidaten en de AI-instellingen. De steekproeven zijn getrokken zonder vaste seed, gelezen zonder bevroren momentopname en verwerkt zonder onafhankelijke referentielabels; ze kunnen de nauwkeurigheid van voorspellingen, de kalibratie of de dekking van antwoorden niet meten.
Het bewijs in het antwoord volgen
| Veld | Betekenis | Beperking |
|---|---|---|
input | Herhaalt het verstuurde type, de waarde en de landcontext | Een invoerwaarde is geen onafhankelijk geverifieerd identiteitsgegeven |
match.name / match.method | Toont de geselecteerde kandidaat en of die is genormaliseerd, als deel of deel van een tekenreeks is afgeleid of door het model is voorspeld | Een match op een deel garandeert niet dat een echte voornaam uit de volledige naam of de gebruikersnaam is gehaald |
match.scope / match.country | Toont of het geselecteerde item uit de landspecifieke of de globale zoekopdracht komt | Een opgegeven land garandeert niet dat er een landspecifiek item beschikbaar was |
sample_count | De opgeslagen totale telling in het geselecteerde item; null bij een voorspelling door AI | Staat niet per se voor unieke personen, onafhankelijk verzamelde waarnemingen of de steekproefgrootte van een nauwkeurigheidsevaluatie |
confidence / confidence_kind | Maakt onderscheid tussen een verhouding uit opgeslagen frequenties en een door het model opgegeven score | Geen van beide waarden is een geverifieerde kans op de genderidentiteit van een persoon |
country / country_source | Landmetadata van het teruggegeven item of een door AI opgegeven koppeling van de naam met een land, indien beschikbaar | Zegt niets over nationaliteit, woonplaats of een geverifieerde herkomst en bewijst niet dat het verstuurde land is gematcht |
Hoe de match van de invoer het resultaat beïnvloedt
De zoekopdracht in de dataset normaliseert de tekst en leidt er kandidaten uit af. Bij e-mailadressen komen de kandidaten uit het deel vóór de @; bij gebruikersnamen wordt een optionele @ aan het begin verwijderd. Normale zoekopdrachten voor e-mailadressen en gebruikersnamen kunnen daarnaast beperkte delen van tekenreeksen controleren. Als er meerdere kandidaat-items zijn, wordt het item met de hoogste opgeslagen totale telling gekozen; dat kan een ander deel zijn dan de bedoelde voornaam.
Als er een landcontext is opgegeven, controleert de zoekopdracht per kandidaat het landspecifieke item en, als dat niet bestaat, het globale item. Het uiteindelijke resultaat vermeldt de geselecteerde match. Een dubbelzinnig landspecifiek item wordt voor die kandidaat niet automatisch vervangen door het globale item.
De normale AI-prompt zoekt naar een herkenbare voornaam. forceToGenderize maakt daarnaast koppelingen via persoonlijke bijnamen of aliassen mogelijk: in die modus is een geslacht anders dan null samen met name: null een geldig resultaat. Dit zijn verschillende voorspellingstaken die apart moeten worden geëvalueerd.
Zoekopdracht in de dataset en verwerking door AI
Als AI wordt gebruikt, stuurt V2 de verstuurde type, value en landcontext door naar de geconfigureerde AI-dienst voor voorspellingen. Bij e-mailadressen vraagt de prompt het model het domein en het achtervoegsel na het plusteken te negeren; dat garandeert niet dat die tekens uit de waarde worden verwijderd voordat AI die verwerkt. Gebruik ai_mode: off zonder forceToGenderize als uw werkproces een voorspelling vereist die alleen de dataset gebruikt.
De validatie van het AI-antwoord controleert de JSON-velden, hun typen en hun onderlinge consistentie. Ze bewijst niet dat de teruggegeven naam, de koppeling met een geslacht of de koppeling met een land juist is. Het openbare resultaat bevat geen identificatie of versie van het model en geen bron die de voorspelling onderbouwt.
| Optie | Voorspellingsweg | Teruggegeven bewijs |
|---|---|---|
| ai_mode: off | Alleen zoekopdracht in de dataset | Metadata van het geselecteerde item of een onbekend resultaat zonder geselecteerd item |
| ai_mode: fallback | Raadpleegt eerst de dataset; gebruikt AI als er geen geslacht is teruggegeven | Bewijs van de uiteindelijke weg, geen gecombineerde steekproef van dataset en AI |
| ai_mode: always | Gebruikt direct de geconfigureerde voorspellingsweg van AI | Een door het model opgegeven score of een onbekend resultaat met confidence null; sample_count is altijd null |
| forceToGenderize: true | Raadpleegt de dataset en gebruikt, als er geen resultaat is, AI die rekening houdt met bijnamen | Bewijs uit de dataset of een door het model opgegeven koppeling via een bijnaam; name kan null zijn |
Brondocumentatie die nog niet is gepubliceerd
Hier is geen gecontroleerde broncatalogus gepubliceerd. Het antwoordcontract en het gedrag van de implementatie zijn op zichzelf niet genoeg om de herkomst van de gegevens, het recht om een bron te gebruiken, de representativiteit ervan of de kwaliteit van de labels te controleren. Voordat er uitspraken over specifieke bronnen worden gedaan, moet de volgende informatie worden gedocumenteerd en gecontroleerd.
Deze beoordeling van de documentatie stelt niet vast of de oorspronkelijke bronnen wel of niet onder een licentie vallen, of dat ze volledig of onvolledig zijn. Ze beschrijft de grenzen van het openbaar beschikbare bewijs. Neem contact op met GenderAPI.io als uw toepassing een beoordeling van een bepaalde bron vereist.
| Bewijs | Vereiste documentatie | Openbare status |
|---|---|---|
| Herkomst en gebruiksrecht | Bij naam genoemde bron of uitgever, verzamelperiode, licentie of een andere gedocumenteerde grondslag voor het gebruik | Hier is geen gecontroleerde catalogus gepubliceerd |
| Verwerkingsgeschiedenis | Transformaties, normalisatie, ontdubbeling, aggregatie en elke synthetische of door een model gegenereerde bijdrage | Blijkt niet uit het label source: dataset |
| Dekking van de populatie | Dekking van landen en schriften, selectieprocedure, definities van de labels en gedocumenteerde vertekening | Hier zijn geen onafhankelijk geëvalueerde dekkingscijfers gepubliceerd |
| Actualiteit | Identificaties van momentopnamen, updatedata per bron en een ondersteund updateschema | Het V2-antwoord bevat geen informatie over de actualiteit per item en geen identificatie van de momentopname |
| Kwaliteit en correcties | Validatieresultaten, controles op overlap, afhandeling van correcties en verwijderingen en de verantwoordelijkheid voor de beoordeling | Hier zijn geen auditresultaten per bron gepubliceerd |
Gegevensbescherming, verwerking en verantwoord gebruik
De herkomst van bronnen, de verwerking van persoonsgegevens en de juridische voorwaarden zijn verschillende vraagstukken. Rollen bij de verwerking, bewaartermijnen, aanbieders en contractuele voorwaarden staan in het beleid dat momenteel is gepubliceerd. Deze technische handleiding voegt geen nieuwe toezeggingen over het bewaren van gegevens toe en certificeert geen naleving van wet- en regelgeving.
Verstuur alleen de gegevens die uw werkproces nodig heeft. Bewaar de soorten betrouwbaarheidsscores en onbekende resultaten en presenteer een voorspelling niet als de identiteit die iemand zelf heeft opgegeven. Gebruik een afgeleid geslacht niet als basis voor beslissingen met belangrijke gevolgen voor een persoon.
Bewijs over nauwkeurigheid en wijzigingsgeschiedenis
Het bronlabel verklaart de voorspellingsweg, niet de gemeten kwaliteit ervan. De handleiding over nauwkeurigheid laat zien hoe u onderscheid maakt tussen scores in antwoorden, de dekking van antwoorden, fouten en de informatie die nodig is voor een reproduceerbare evaluatie.
| Datum | Versie van het document | Wijziging |
|---|---|---|
| 2026-09-28 | 1.0.0 | Nederlandse versie van de gedateerde inventaris van MongoDB, de consistentiecontroles in de steekproeven, de V2-velden source en match, de grenzen van de verwerking door AI en de resterende hiaten in de broncatalogus. De gelijkwaardigheid van MongoDB en Redis berust op de bevestiging van GenderAPI.io van 26 september 2026; de onafhankelijke vergelijking moet nog plaatsvinden. Er is geen nauwkeurigheidspercentage en geen uitspraak over de licentie van bronnen toegevoegd. |