API-documentatie Unified API v2.0

Aanvraag vereist: 1

URL	https://gender-api.com/v2/gender
Headers	Content-Type: application/json Authorization: Bearer <uw autorisatietoken> link
JSON Payload	Veld Type Verplicht Beschrijving full_name string Ja Naam om op te vragen country string Nee ISO 3166 ALPHA-2 landcode link locale string Nee Browser Taalinstelling ip string Nee Geldig IPv4 of IPv6 adres id string Nee Max 50 tekens. Je kunt deze id instellen op elke alfanumerieke waarde die je wilt. Als voorbeeld kun je de id instellen op je interne id van de dataset in je database. In een asynchroon omgeving kan dit je helpen om de respons beter te verbinden met een eerdere aanvraag

Voorbeelden

{"full_name":"Theresa Miller"}

{"full_name":"Theresa Miller","country":"US"}

{"full_name":"Thomas Johnson","locale":"en_US"}

{"full_name":"Markus Stefan NonExistingLastName","ip":"54.201.16.177"}

[{"full_name":"Theresa Miller"},{"full_name":"Thomas Johnson","country":"US"}]

{
    "input": {
        "full_name": "Theresa Miller"
    },
    "details": {
    "credits_used": 1,
        "duration": "33ms",
        "samples": 8961,
        "country": null,
        "first_name_sanitized": "theresa"
    },
    "result_found": true,
    "last_name": "Miller",
    "first_name": "Theresa",
    "probability": 0.98,
    "gender": "female"
}

Veld	Type	Beschrijving
input	object	De ingediende payload
details.credits_used	int	Het aantal verzoeken dat voor deze query is gebruikt
details.samples	int	Aantal gevonden records in onze database die overeenkomen met uw verzoek
details.country	string	Het land dat we hebben gevonden
details.full_name_sanitized	int	De naam nadat we onze normalisator erop hebben toegepast
details.duration	string	Tijd die de server nodig had om het verzoek te verwerken
result_found	bool	True als we een gender hebben kunnen vinden voor de gegeven naam
full_name	string	De volledige naam die wij gebruiken voor genderisering
probability	float	Deze waarde (tussen 0 en 1) bepaalt de betrouwbaarheid van onze database. Een waarde van 1 betekent dat de resultaten van uw genderverzoek 100% nauwkeurig zijn.
gender	string	Mogelijke waarden: mannelijk, vrouwelijk, onbekend