İstemci kütüphaneleri
REST API üzerinde ince sarmalayıcılar. Anahtarınızı gönderir, her isteği oluşturur ve hata yanıtlarını istisnalara dönüştürürler.
Kullanmanız gerekmez. API birkaç sade JSON endpoint'inden ibarettir; bir kütüphane size bir projeyi değil, bir öğleden sonrayı kazandırır. Diliniz listede yoksa REST referansında kopyala-yapıştır örnekleri var.
REST API Referansı →
JavaScript
Node.js · Deno · Bun · npm
npm install namegender
Kopyalanamadı. Metni seçip kopyalayın.
import { NameGender } from 'namegender';
const client = new NameGender('YOUR_API_KEY');
const result = await client.name('Ayşe', { country: 'TR' });
console.log(result.gender); // "female"
console.log(result.confidence); // "unverified" | "low" | "medium" | "high"
// Many names in one request
const many = await client.bulk(['Ayşe', 'Mehmet', 'Priya']);
Kopyalanamadı. Metni seçip kopyalayın.
Command line
macOS · Linux · Windows · Node.js 18+
npm install -g namegender
Kopyalanamadı. Metni seçip kopyalayın.
export NAMEGENDER_API_KEY=YOUR_API_KEY
npx namegender Andrea --country IT
npx namegender --email jane.doe@example.com
# One value per line in, CSV out
cat names.txt | npx namegender --csv > genders.csv
Kopyalanamadı. Metni seçip kopyalayın.
PHP
PHP 8.1+
composer require namegender/namegender
Kopyalanamadı. Metni seçip kopyalayın.
use NameGender\Client;
$client = new Client('YOUR_API_KEY');
$result = $client->name('Ayşe', country: 'TR');
echo $result['gender']; // "female"
echo $result['confidence']; // "unverified" | "low" | "medium" | "high"
// Many names in one request
$many = $client->bulk(['Ayşe', 'Mehmet', 'Priya']);
Kopyalanamadı. Metni seçip kopyalayın.
Python
Python 3.9+
pip install namegender-client
Kopyalanamadı. Metni seçip kopyalayın.
from namegender import NameGender
client = NameGender("YOUR_API_KEY")
result = client.name("Ayşe", country="TR")
print(result["gender"]) # "female"
print(result["confidence"]) # evidence level
# Many names in one request
many = client.bulk(["Ayşe", "Mehmet", "Priya"])
Kopyalanamadı. Metni seçip kopyalayın.
Ruby
Ruby 3.0+
gem install namegender
Kopyalanamadı. Metni seçip kopyalayın.
require "namegender"
client = NameGender::Client.new("YOUR_API_KEY")
result = client.name("Ayşe", country: "TR")
puts result["gender"] # "female"
puts result["confidence"] # evidence level
Kopyalanamadı. Metni seçip kopyalayın.
Java
Java 17+ · JitPack
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
<dependency>
<groupId>com.github.anpekesen</groupId>
<artifactId>namegender-java</artifactId>
<version>v0.9.0</version>
</dependency>
Kopyalanamadı. Metni seçip kopyalayın.
var client = new NameGender("YOUR_API_KEY");
var result = client.name("Ayşe", "TR");
System.out.println(result.gender()); // "female"
System.out.println(result.confidence());
Kopyalanamadı. Metni seçip kopyalayın.
C# / .NET
.NET Standard 2.0 · .NET 8 · NuGet
dotnet add package NameGender --version 0.6.0
Kopyalanamadı. Metni seçip kopyalayın.
using var client = new NameGenderClient("YOUR_API_KEY");
var result = await client.NameAsync("Ayşe", new LookupOptions { Country = "TR" });
Console.WriteLine(result.Gender); // "female"
Console.WriteLine(result.Confidence);
Kopyalanamadı. Metni seçip kopyalayın.
Go
Go 1.21+
go get github.com/anpekesen/namegender-go@v0.7.0
Kopyalanamadı. Metni seçip kopyalayın.
client := namegender.New("YOUR_API_KEY")
result, err := client.Name(ctx, "Ayşe", namegender.Options{Country: "TR"})
fmt.Println(result.Gender) // "female"
fmt.Println(result.Confidence)
Kopyalanamadı. Metni seçip kopyalayın.
R
R 4.1+ · GitHub
remotes::install_github('anpekesen/namegender-r', ref = 'v0.7.0')
Kopyalanamadı. Metni seçip kopyalayın.
library(namegender)
client <- namegender("YOUR_API_KEY")
result <- ng_name(client, "Ayşe", country = "TR")
result$gender # "female"
result$confidence
# A whole data frame in one call
df$gender <- ng_bulk(client, df$name)$results$gender
Kopyalanamadı. Metni seçip kopyalayın.
PowerShell
Windows PowerShell 5.1 · PowerShell 7 · PowerShell Gallery
Install-Module NameGender
Kopyalanamadı. Metni seçip kopyalayın.
$env:NAMEGENDER_API_KEY = 'YOUR_API_KEY'
Get-NameGender Andrea -Country IT
# A whole file: pipeline input goes out in bulk requests
Get-Content names.txt | Get-NameGender | Export-Csv genders.csv -NoTypeInformation
Kopyalanamadı. Metni seçip kopyalayın.
Rust
async · reqwest + rustls · crates.io
cargo add namegender
Kopyalanamadı. Metni seçip kopyalayın.
use namegender::{NameGender, Options};
let client = NameGender::new("YOUR_API_KEY");
let r = client
.name("Ayşe", &Options { country: Some("TR".into()), ..Default::default() })
.await?;
println!("{:?}", r.gender); // Some("female")
Kopyalanamadı. Metni seçip kopyalayın.
Başka bir dil gerekli mi?
Bize hangisini söyleyin ve bakacağız. API yüzeyi yeterince küçük olduğu için bir topluluk sarmalayıcısı hafta sonu işi ve burada bağlayacağız.
Destek ile iletişime geçin