⚡ Unified API v2.0 ADVANCED

API DOCUMENTATION

हमारे high-performance unified API का अनुभव करो, जो ज़्यादा रिक्वेस्ट वॉल्यूम वाले advanced यूज़र्स के लिए डिज़ाइन किया गया है। एक ही रिक्वेस्ट में कई नामों पर क्वेरी करो, वो भी बेहद तेज़ response time के साथ।

पहले नाम से क्वेरी करो

किसी नाम से gender जानने का ये सबसे आसान तरीका है। हर जवाब JSON में एन्कोड होता है:

POST https://gender-api.com/v2/gender

info ज़रूरी रिक्वेस्ट्स: 1

http Headers

Content-Type: application/json

Authorization: Bearer <your authorization token>

link

data_object JSON Payload

फ़ील्ड	टाइप करें	ज़रूरी	विवरण
`first_name`	string	हाँ	जिस नाम पर क्वेरी करनी है
`country`	string	नहीं	ISO 3166 ALPHA-2 Country Code link
`locale`	string	नहीं	ब्राउज़र लोकेल
`ip`	string	नहीं	वैध IPv4 या IPv6 पता
`id`	string	नहीं	अधिकतम 50 अक्षर। तुम इस आईडी को अपनी पसंद के किसी भी अल्फ़ान्यूमेरिक मान पर सेट कर सकते हो। उदाहरण के लिए, तुम आईडी को अपने डेटाबेस में मौजूद डेटा सेट की इंटरनल आईडी पर सेट कर सकते हो। एक asynchronous वातावरण में यह तुम्हें किसी response को पिछली request से बेहतर ढंग से जोड़ने में मदद करता है

code रिक्वेस्ट के उदाहरण

arrow_forward सिर्फ पहले नाम से क्वेरी करो

play_arrow Codepen.io पर लाइव ट्राय करो

{
    "first_name": "Sandra"
}

arrow_forward पहले नाम और country code से क्वेरी करो

play_arrow Codepen.io पर लाइव ट्राय करो

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

arrow_forward पहले नाम और browser locale से क्वेरी करो

play_arrow Codepen.io पर लाइव ट्राय करो

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

arrow_forward पहले नाम से क्वेरी करो और localization के लिए IP address का इस्तेमाल करो

play_arrow Codepen.io पर लाइव ट्राय करो

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

arrow_forward एक ही रिक्वेस्ट में कई नामों की क्वेरी करो

play_arrow Codepen.io पर लाइव ट्राय करो

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

check_circle रिस्पॉन्स

{
    "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 रिस्पॉन्स फ़ील्ड्स

फ़ील्ड	टाइप करें	विवरण
`input`	object	भेजा गया payload
`details.credits_used`	int	इस क्वेरी के लिए इस्तेमाल की गई requests की संख्या
`details.samples`	int	हमारे डेटाबेस में तुम्हारी request से मेल खाते हुए मिले रिकॉर्ड्स की संख्या
`details.country`	string	वह देश जो हमें मिला
`details.first_name_sanitized`	string	वह नाम, जिस पर हमने अपना normalizer लागू किया है
`details.duration`	string	सर्वर को request प्रोसेस करने में लगा समय
`result_found`	bool	True, अगर हम दिए गए नाम के लिए gender क्वेरी करने में सक्षम रहे
`first_name`	string	genderization के लिए हमने जो पहला नाम इस्तेमाल किया है
`probability`	float	यह मान (0 और 1 के बीच) हमारी डेटाबेस की विश्वसनीयता दर्शाता है। मान 1 होने का मतलब है कि तुम्हारी gender request के नतीजे 100%% सटीक हैं।
`gender`	string	संभावित मान: male, female, unknown