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

Zoek op voornaam

Dit is de gemakkelijkste manier om het geslacht van een naam op te zoeken. Elke respons is in JSON-indeling gecodeerd:

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
`first_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 Opzoeken op voornaam alleen

play_arrow Probeer live op Codepen.io

{
    "first_name": "Sandra"
}

arrow_forward Opzoeken op voornaam en landcode

play_arrow Probeer live op Codepen.io

{
    "first_name": "Sandra",
    "country": "US"
}

arrow_forward Zoekopdracht op voornaam en browsertaal

play_arrow Probeer live op Codepen.io

{
    "first_name": "Sandra",
    "locale": "en_US"
}

arrow_forward Zoekopdracht op voornaam en gebruik een IP-adres voor lokalisatie

play_arrow Probeer live op Codepen.io

{
    "first_name": "Sandra",
    "ip": "54.201.16.177"
}

arrow_forward Meerdere namen zoeken in één verzoek

play_arrow Probeer live op Codepen.io

[
    {
        "first_name": "Sandra",
        "country": "US"
    },
    {
        "first_name": "Jason",
        "country": "US"
    }
]

check_circle Reactie

{
    "input": {
        "first_name": "Sandra"
    },
    "details": {
        "credits_used": 1,
        "samples": 464,
        "country": null,
        "first_name_sanitized": "sandra",
        "duration": "436ms"
    },
    "result_found": true,
    "first_name": "Sandra",
    "probability": 0.85,
    "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.first_name_sanitized`	string	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
`first_name`	string	De voornaam die we gebruikten voor genderclassificatie
`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