Bericht
Aanvraag vereist: 1
| URL |
https://gender-api.com/v2/gender
|
| Headers |
Content-Type: application/json
|
| 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 |
|
Voorbeelden
Opzoeken op voornaam alleen
{"first_name":"Sandra"}
Opzoeken op voornaam en landcode
{"first_name":"Sandra","country":"US"}
Zoekopdracht op voornaam en browsertaal
{"first_name":"Sandra","locale":"en_US"}
Zoekopdracht op voornaam en gebruik een IP-adres voor lokalisatie
{"first_name":"Sandra","ip":"54.201.16.177"}
Meerdere namen zoeken in één verzoek
[{"first_name":"Sandra","country":"US"},{"first_name":"Jason","country":"US"}]
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"
}
| 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 |