API-documentatie Unified API v2.0

API v1.0

We bieden ook een andere API-versie aan met eindpunten die gemakkelijker te integreren zijn. Als je een beginner bent in het implementeren van API's, kun je overschakelen naar ons endpoint v1.0.
Bekijk API v1.0

OpenAPI

Bekijk onze API-documentatie in Swagger

Postman

Importeer onze API-definitie in Postman
Zoek op voornaam
Zoeken op volledige naam
Zoek op e-mailadres
Haal het land van oorsprong op
Bekijk statistieken
Foutcodes

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:

Bericht
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

Zoekopdracht op volledige naam
play_arrow Testen live met codepen.io 
{"full_name":"Theresa Miller"}
Zoekopdracht op volledige naam en landcode
play_arrow Testen live met codepen.io 
{"full_name":"Theresa Miller","country":"US"}
Zoekopdracht op volledige naam en browsertaal
play_arrow Testen live met codepen.io 
{"full_name":"Thomas Johnson","locale":"en_US"}
Zoek op volledige naam en gebruik een IP-adres voor lokaliseren
play_arrow Testen live met codepen.io 
{"full_name":"Markus Stefan NonExistingLastName","ip":"54.201.16.177"}
Meerdere namen zoeken in één verzoek
play_arrow Testen live met codepen.io 
[{"full_name":"Theresa Miller"},{"full_name":"Thomas Johnson","country":"US"}]
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"
}
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
Dit product bevat GeoLite2-gegevens die zijn gemaakt door MaxMind, beschikbaar op http://www.maxmind.com.
Chat