Tiếp tục → Tổng quan

Thư viện client

Wrapper mỏng trên REST API. Chúng gửi khóa của bạn, dựng từng yêu cầu và chuyển các phản hồi lỗi thành ngoại lệ.

Bạn không cần đến. API chỉ gồm vài endpoint JSON đơn giản; thư viện tiết kiệm cho bạn một buổi chiều, không phải một dự án. Nếu ngôn ngữ của bạn không được liệt kê, tham chiếu REST có các ví dụ sao chép dán.

Tài liệu tham khảo REST API →
JavaScript
Node.js · Deno · Bun · npm
Cài đặt
npm install namegender

Không thể sao chép. Hãy chọn và sao chép văn bản.

Cách sử dụng
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']);

Không thể sao chép. Hãy chọn và sao chép văn bản.

Command line
macOS · Linux · Windows · Node.js 18+
Cài đặt
npm install -g namegender

Không thể sao chép. Hãy chọn và sao chép văn bản.

Cách sử dụng
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

Không thể sao chép. Hãy chọn và sao chép văn bản.

PHP
PHP 8.1+
Cài đặt
composer require namegender/namegender

Không thể sao chép. Hãy chọn và sao chép văn bản.

Cách sử dụng
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']);

Không thể sao chép. Hãy chọn và sao chép văn bản.

Python
Python 3.9+
Cài đặt
pip install namegender-client

Không thể sao chép. Hãy chọn và sao chép văn bản.

Cách sử dụng
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"])

Không thể sao chép. Hãy chọn và sao chép văn bản.

Ruby
Ruby 3.0+
Cài đặt
gem install namegender

Không thể sao chép. Hãy chọn và sao chép văn bản.

Cách sử dụng
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

Không thể sao chép. Hãy chọn và sao chép văn bản.

Java
Java 17+ · JitPack
Cài đặt
<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>

Không thể sao chép. Hãy chọn và sao chép văn bản.

Cách sử dụng
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());

Không thể sao chép. Hãy chọn và sao chép văn bản.

C# / .NET
.NET Standard 2.0 · .NET 8 · NuGet
Cài đặt
dotnet add package NameGender --version 0.6.0

Không thể sao chép. Hãy chọn và sao chép văn bản.

Cách sử dụng
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);

Không thể sao chép. Hãy chọn và sao chép văn bản.

Go
Go 1.21+
Cài đặt
go get github.com/anpekesen/namegender-go@v0.7.0

Không thể sao chép. Hãy chọn và sao chép văn bản.

Cách sử dụng
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)

Không thể sao chép. Hãy chọn và sao chép văn bản.

R
R 4.1+ · GitHub
Cài đặt
remotes::install_github('anpekesen/namegender-r', ref = 'v0.7.0')

Không thể sao chép. Hãy chọn và sao chép văn bản.

Cách sử dụng
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

Không thể sao chép. Hãy chọn và sao chép văn bản.

PowerShell
Windows PowerShell 5.1 · PowerShell 7 · PowerShell Gallery
Cài đặt
Install-Module NameGender

Không thể sao chép. Hãy chọn và sao chép văn bản.

Cách sử dụng
$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

Không thể sao chép. Hãy chọn và sao chép văn bản.

Rust
async · reqwest + rustls · crates.io
Cài đặt
cargo add namegender

Không thể sao chép. Hãy chọn và sao chép văn bản.

Cách sử dụng
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")

Không thể sao chép. Hãy chọn và sao chép văn bản.

Cần ngôn ngữ khác?

Cho chúng tôi biết ngôn ngữ nào và chúng tôi sẽ xem xét. Bề mặt API đủ nhỏ để một wrapper cộng đồng là công việc trong một tuần cuối, và chúng tôi sẽ liên kết nó ở đây.

Liên hệ hỗ trợ