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
npm install namegender
Không thể sao chép. Hãy chọn và sao chép văn bả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']);
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+
npm install -g namegender
Không thể sao chép. Hãy chọn và sao chép văn bả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
Không thể sao chép. Hãy chọn và sao chép văn bản.
PHP
PHP 8.1+
composer require namegender/namegender
Không thể sao chép. Hãy chọn và sao chép văn bả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']);
Không thể sao chép. Hãy chọn và sao chép văn bản.
Python
Python 3.9+
pip install namegender-client
Không thể sao chép. Hãy chọn và sao chép văn bả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"])
Không thể sao chép. Hãy chọn và sao chép văn bản.
Ruby
Ruby 3.0+
gem install namegender
Không thể sao chép. Hãy chọn và sao chép văn bả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
Không thể sao chép. Hãy chọn và sao chép văn bả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>
Không thể sao chép. Hãy chọn và sao chép văn bả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());
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
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.
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+
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.
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
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.
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
Install-Module NameGender
Không thể sao chép. Hãy chọn và sao chép văn bả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
Không thể sao chép. Hãy chọn và sao chép văn bản.
Rust
async · reqwest + rustls · crates.io
cargo add namegender
Không thể sao chép. Hãy chọn và sao chép văn bả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")
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ợ