कमांड लाइन क्लाइंट
अपने टर्मिनल से सीधे डेटा को समृद्ध (Enrich) करो
हमारा नया Command Line Client Go में बना एक statically compiled, high-performance टूल है। ये डेवलपर्स और डेटा साइंटिस्ट्स को अपने टर्मिनल से ही Gender-API.com के साथ सीधे काम करने की सुविधा देता है—बिना किसी wrapper code लिखे।
यह macOS और Linux पर नैटिवली चलता है, जिससे यह ऑटोमेटेड bash scripts, cron jobs, या तुम्हारी लोकल data science pipelines में इंटीग्रेट करने के लिए एकदम परफेक्ट है।
मुख्य फायदे
- क्रॉस-प्लैटफ़ॉर्म: macOS, Linux aur Windows ke liye ek hi single binary mein compile hota hai.
- तेज़ और हल्का-फुल्का: अधिकतम एक्ज़ीक्यूशन स्पीड और ज़ीरो रनटाइम डिपेंडेंसीज़ के लिए Go में बिल्ट।
- Pipe-Friendly;;पाइप के अनुकूल: स्टैण्डर्ड POSIX स्ट्रीम्स का इस्तेमाल करके डेटा को आसानी से इनपुट और आउटपुट करो। sed, awk, jq या ClaudeBot जैसे AI टूल्स के साथ आसानी से इंटीग्रेट करो।
- कवरेज: Name, Email, Country of Origin और Account Statistics समेत सभी प्रमुख V2 endpoints को सपोर्ट करता है।
यह कैसे काम करता है
CLI क्लाइंट के साथ शुरुआत करना तेज़ और आसान है।
1. अपनी API कुंजी कॉन्फ़िगर करें
अपनी रिक्वेस्ट्स को सुरक्षित तरीके से ऑथेंटिकेट करने के लिए, ताकि तुम्हारी bash history में keys लॉग न हों, तुम या तो इसे environment variable के रूप में export कर सकते हो या फिर इसे किसी configuration file में save कर सकते हो।
विकल्प A: पर्यावरण वेरिएबल
export GENDER_API_KEY="your-api-key-here"
विकल्प B: कॉन्फ़िगरेशन फ़ाइल
अपने यूज़र के होम डायरेक्टरी में .gender-api-key नाम की एक फ़ाइल बनाओ, और उसमें सिर्फ़ अपना टोकन लिखो:
echo "your-api-key-here" > ~/.gender-api-key
2. API को क्वेरी करो
CLI तुम्हें सभी मुख्य endpoints के साथ इंटरैक्ट करने देता है। यहाँ कुछ उदाहरण हैं:
पहले नाम से खोजें
$ gender-api-cli -first_name "Sandra" -country "US"
पूरा नाम से खोजें
$ gender-api-cli -full_name "Theresa Miller"
ईमेल पते से क्वेरी करो
$ gender-api-cli -email "thomasfreeman@example.com"
मूल देश निर्धारित करें
किसी नाम का सबसे ज़्यादा किस जगह/देश से होने की संभावना है, यह जानने के लिए बस अंत में -origin फ़्लैग जोड़ दो:
$ gender-api-cli -first_name "Sandra" -origin
अकाउंट के आँकड़े देखें
बिना कोई सर्च इस्तेमाल किए, अपने बचे हुए क्रेडिट्स जल्दी से चेक करो:
$ gender-api-cli -stats
3. स्क्रिप्ट्स के साथ ऑटोमेट करो
दमदार Bash स्क्रिप्ट्स बनाओ। जैसे, एक टेक्स्ट फाइल से नाम पढ़ो, API को क्वेरी करो, और रिज़ल्ट्स को एक स्ट्रक्चर्ड JSON फाइल में append करो—जो ClaudeBot या ChatGPT में आसानी से ingest हो सके।
#!/bin/bash
while read name; do
gender-api-cli -first_name "$name" -out=json >> enriched_data.json
done < names.txt
अक्सर पूछे जाने वाले प्रश्न
क्या CLI क्लाइंट ओपन सोर्स है?
हाँ, CLI पूरी तरह से ओपन-सोर्स है। तुम कोड रिव्यू कर सकते हो, सुधार सुझा सकते हो, या हमारे GitHub रिपॉज़िटरी से सोर्स कोड के ज़रिए इसे खुद कंपाइल कर सकते हो।
क्या यह बल्क प्रोसेसिंग को सपोर्ट करता है?
अभी CLI एक बार में सिर्फ़ एक ही API क्वेरी चलाने को सपोर्ट करता है, लेकिन इसे बेहद तेज़ बनाने के लिए बनाया गया है। हज़ारों रो के लिए तुम आसानी से xargs या bash loop का इस्तेमाल कर सकते हो। लाखों लाइनों वाले बड़े डेटासेट के लिए हम अब भी डैशबोर्ड में मौजूद अपनी CSV/Excel अपलोड फीचर की सलाह देते हैं।
क्या मैं रॉ JSON आउटपुट कर सकता हूँ?
हाँ! तुम `"-out=json"` फ़्लैग पास कर सकते हो ताकि बिना फ़ॉर्मैट किया हुआ, रॉ JSON रिस्पॉन्स सीधे standard output पर मिल जाए—जिससे यह jq प्रोसेसर चेन के लिए एकदम परफेक्ट बन जाता है।
macOS में “Apple यह सत्यापित नहीं कर सका कि यह मैलवेयर से मुक्त है”?
CLI एक सीधा बाइनरी डाउनलोड है, App Store से इंस्टॉल किया हुआ ऐप नहीं—इसलिए macOS Gatekeeper इसे डिफ़ॉल्ट रूप से ब्लॉक/सुरक्षित करता है। इसे चलाने की अनुमति देने के लिए, अपना Terminal खोलो और ये कमांड चलाकर quarantine फ़्लैग हटा दो:
xattr -d com.apple.quarantine /path/to/downloaded/executable
कोई भी प्रश्न है?
