Komut Satırı İstemcisi

Gender-API CLI Aracı Entegrasyonu
Geliştirici Aracı

Güncel Sürüm: v1.0.4

Verileri Doğrudan Terminalinden Zenginleştir

Yeni Komut Satırı İstemcimiz, Go ile geliştirilmiş, statik olarak derlenmiş ve yüksek performanslı bir araçtır. Geliştiricilerin ve veri bilimcilerin, hiçbir sarmalayıcı (wrapper) kod yazmadan doğrudan terminal üzerinden Gender-API.com ile etkileşime geçmesini sağlar.

macOS ve Linux’te yerel olarak çalışır; bu da onu otomatik bash script’leri, cron job’lar veya yerel veri bilimi pipeline’larına entegre etmek için mükemmel bir seçenek haline getirir.

Temel Avantajlar

  • Çapraz Platform: macOS, Linux ve Windows için tek bir çalıştırılabilir dosya (binary) olarak derlenir.
  • Hızlı ve Hafif: Maksimum çalışma hızı ve sıfır çalışma zamanı bağımlılığı için Go ile geliştirildi.
  • Boru Dostu: Standart POSIX akışlarını kullanarak verileri kolayca içeri ve dışarı aktar. sed, awk, jq veya ClaudeBot gibi yapay zekâ araçlarıyla entegre et.
  • Kapsam: Ad, E-posta, Menşe Ülke ve Hesap İstatistikleri dâhil tüm önemli V2 uç noktalarını destekler.

Nasıl Çalışır

CLI istemcisiyle kullanmaya başlamak hızlı ve oldukça kolay.

1. API Anahtarını Yapılandır

İsteklerini bash geçmişine anahtar kaydetmeden güvenli bir şekilde doğrulamak için, anahtarını ya bir ortam değişkeni olarak dışa aktarabilir ya da bir yapılandırma dosyasına kaydedebilirsin.

Seçenek A: Ortam Değişkeni

export GENDER_API_KEY="your-api-key-here"

Seçenek B: Yapılandırma Dosyası

Kullanıcının ana dizininde yalnızca token’ını içeren .gender-api-key adında bir dosya oluştur:

echo "your-api-key-here" > ~/.gender-api-key
API Anahtarını Al

2. API’yi sorgula

CLI, tüm önemli endpoint’lerle etkileşime geçmeni sağlar. İşte birkaç örnek:

İsme Göre Sorgula

$ gender-api-cli -first_name "Sandra" -country "US"

Tam Adına Göre Sorgula

$ gender-api-cli -full_name "Theresa Miller"

E-posta Adresiyle Sorgula

$ gender-api-cli -email "thomasfreeman@example.com"

Menşe Ülkesini Belirle

Bir ismin büyük olasılıkla nereden geldiğini öğrenmek için, sonuna sadece -origin etiketini ekle:

$ gender-api-cli -first_name "Sandra" -origin

Hesap İstatistiklerini Kontrol Et

Hiç arama harcamadan kalan kredilerini hızlıca kontrol et:

$ gender-api-cli -stats

3. Scriptlerle Otomatikleştir

Güçlü bash script’leri oluştur. Örneğin, bir metin dosyasından isimleri oku, API’ye sorgu at ve sonuçları ClaudeBot veya ChatGPT’nin içeri aktarabileceği şekilde yapılandırılmış bir JSON dosyasına ekle.

#!/bin/bash
while read name; do
  gender-api-cli -first_name "$name" -out=json >> enriched_data.json
done < names.txt

Sıkça Sorulan Sorular

01

CLI istemcisi açık kaynak mı?

Evet, CLI tamamen açık kaynaklı. Kodları inceleyebilir, iyileştirme önerilerinde bulunabilir veya GitHub depomuz üzerinden kaynak koddan derleyebilirsin.

02

Toplu işlemeyi destekliyor mu?

Şu anda CLI, aynı anda yalnızca tek bir API sorgusu göndermeyi destekliyor; ancak inanılmaz derecede hızlı olacak şekilde tasarlandı. Binlerce satır için xargs ya da bir bash döngüsüyle bunu kolayca yapabilirsin. Milyonlarca satırdan oluşan devasa veri setleri içinse, kontrol panelindeki CSV/Excel yükleme özelliğimizi hâlâ öneriyoruz.

03

Ham JSON çıktısı alabilir miyim?

Evet! Biçimlendirilmemiş, ham JSON yanıtını doğrudan standart çıktıya almak için "-out=json" bayrağını ekleyebilirsin. Böylece jq ile kuracağın işlem zincirleri için de harika olur.

04

macOS “Apple bunun kötü amaçlı yazılım içermediğini doğrulayamadı” mı diyor?

CLI, App Store’dan yüklenen bir uygulama olmadığı için doğrudan bir ikili dosya (binary) indirmen anlamına gelir. Bu yüzden macOS Gatekeeper, varsayılan olarak onu engeller/korumaya alır. Çalıştırmaya izin vermek için Terminal’i aç ve karantina (quarantine) işaretini şu komutla kaldır:

xattr -d com.apple.quarantine /path/to/downloaded/executable

Herhangi bir sorunuz var mı?

Sohbet