⚡ Geünificeerde API v2.0 GEVORDERD

API-DOCUMENTATIE

Ervaar onze high-performance, geünificeerde API, ontworpen voor gevorderde gebruikers met hoge aantallen aanvragen. Vraag meerdere namen op in één verzoek met bliksemsnelle responstijden.

Zoeken op e-mailadres

U kunt ook een geslacht opvragen met behulp van een e-mailadres met een e-mailadres:

POST https://gender-api.com/v2/gender

info Aanvraag vereist: 1

http Headers

Content-Type: application/json

Authorization: Bearer <uw autorisatietoken>

link

data_object JSON Payload

Veld	Type	Verplicht	Beschrijving
`email`	string	Ja	Voer e-mailadres in om op te zoeken
`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

code Voorbeeldverzoeken

arrow_forward Zoeken op alleen het e-mailadres

play_arrow Probeer live op Codepen.io

{
    "email": "theresa.miller14@gmail.com"
}

arrow_forward Zoeken op e-mailadres en landcode

play_arrow Probeer live op Codepen.io

{
    "email": "thomas.clarks@hotmail.com",
    "country": "US"
}

arrow_forward Opvragen op basis van e-mailadres en browser-locatie

play_arrow Probeer live op Codepen.io

{
    "email": "Thomas.j32@live.com",
    "locale": "en_US"
}

arrow_forward Zoeken op e-mailadres en gebruik een IP-adres voor lokaliseren

play_arrow Probeer live op Codepen.io

{
    "email": "thomasfromnewyork@gmail.com",
    "ip": "54.201.16.177"
}

arrow_forward Meerdere namen zoeken in één verzoek

play_arrow Probeer live op Codepen.io

[
    {
        "email": "thomas.clarks@hotmail.com",
        "country": "US"
    },
    {
        "email": "theresa.miller14@gmail.com"
    }
]

check_circle Reactie

{
    "input": {
        "email": "theresa.miller14@gmail.com"
    },
    "details": {
        "credits_used": 1,
        "duration": "12ms",
        "samples": 8961,
        "country": null,
        "first_name_sanitized": "theresa"
    },
    "result_found": true,
    "last_name": "Miller",
    "first_name": "Theresa",
    "probability": 0.98,
    "gender": "female"
}

list Antwoordvelden

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.email_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
`email`	string	Het e-mailadres dat we gebruikten voor genderisatie
`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