Bericht
Aanvraag vereist: 1
URL |
https://gender-api.com/v2/gender
|
Headers |
Content-Type: application/json
|
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
{"full_name":"Theresa Miller"}
Zoekopdracht op volledige naam en landcode
{"full_name":"Theresa Miller","country":"US"}
Zoekopdracht op volledige naam en browsertaal
{"full_name":"Thomas Johnson","locale":"en_US"}
Zoek op volledige naam en gebruik een IP-adres voor lokaliseren
{"full_name":"Markus Stefan NonExistingLastName","ip":"54.201.16.177"}
Meerdere namen zoeken in één verzoek
[{"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 |