Klientské knihovny
Tenké obaly kolem REST API. Posílají váš klíč, sestavují každý požadavek a chybové odpovědi převádějí na výjimky.
Nepotřebujete. API tvoří jen hrstka endpointů s prostým JSON; knihovna vám ušetří odpoledne, ne projekt. Není-li váš jazyk v seznamu, má REST reference příklady ke kopírování.
Referenční dokumentace REST API →
JavaScript
Node.js · Deno · Bun · npm
npm install namegender
Kopírování selhalo. Vyberte a zkopírujte text.
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']);
Kopírování selhalo. Vyberte a zkopírujte text.
Command line
macOS · Linux · Windows · Node.js 18+
npm install -g namegender
Kopírování selhalo. Vyberte a zkopírujte text.
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
Kopírování selhalo. Vyberte a zkopírujte text.
PHP
PHP 8.1+
composer require namegender/namegender
Kopírování selhalo. Vyberte a zkopírujte text.
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']);
Kopírování selhalo. Vyberte a zkopírujte text.
Python
Python 3.9+
pip install namegender-client
Kopírování selhalo. Vyberte a zkopírujte text.
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"])
Kopírování selhalo. Vyberte a zkopírujte text.
Ruby
Ruby 3.0+
gem install namegender
Kopírování selhalo. Vyberte a zkopírujte text.
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
Kopírování selhalo. Vyberte a zkopírujte text.
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>
Kopírování selhalo. Vyberte a zkopírujte text.
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());
Kopírování selhalo. Vyberte a zkopírujte text.
C# / .NET
.NET Standard 2.0 · .NET 8 · NuGet
dotnet add package NameGender --version 0.6.0
Kopírování selhalo. Vyberte a zkopírujte text.
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);
Kopírování selhalo. Vyberte a zkopírujte text.
Go
Go 1.21+
go get github.com/anpekesen/namegender-go@v0.7.0
Kopírování selhalo. Vyberte a zkopírujte text.
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)
Kopírování selhalo. Vyberte a zkopírujte text.
R
R 4.1+ · GitHub
remotes::install_github('anpekesen/namegender-r', ref = 'v0.7.0')
Kopírování selhalo. Vyberte a zkopírujte text.
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
Kopírování selhalo. Vyberte a zkopírujte text.
PowerShell
Windows PowerShell 5.1 · PowerShell 7 · PowerShell Gallery
Install-Module NameGender
Kopírování selhalo. Vyberte a zkopírujte text.
$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
Kopírování selhalo. Vyberte a zkopírujte text.
Rust
async · reqwest + rustls · crates.io
cargo add namegender
Kopírování selhalo. Vyberte a zkopírujte text.
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")
Kopírování selhalo. Vyberte a zkopírujte text.
Potřebujete jiný jazyk?
Řekněte nám, který, a podíváme se na to. Plocha API je natolik malá, že komunitní wrapper se naprogramuje za víkend a my ho zde odkážeme.
Kontaktujte podporu