⚡ 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 volledige naam - SCHEIDT VOORNAAM EN ACHTERNAAM

Als u een gecombineerd veld gebruikt voor voornaam en achternaam op uw pagina, gebruik dan deze API om de delen te extraheren:

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
`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

code Voorbeeldverzoeken

arrow_forward Zoekopdracht op volledige naam

play_arrow Probeer live op Codepen.io

{
    "full_name": "Theresa Miller"
}

arrow_forward Zoekopdracht op volledige naam en landcode

play_arrow Probeer live op Codepen.io

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

arrow_forward Zoekopdracht op volledige naam en browsertaal

play_arrow Probeer live op Codepen.io

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

arrow_forward Zoek op volledige naam en gebruik een IP-adres voor lokaliseren

play_arrow Probeer live op Codepen.io

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

arrow_forward Meerdere namen zoeken in één verzoek

play_arrow Probeer live op Codepen.io

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

check_circle Reactie

{
    "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"
}

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.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