Weiter → Übersicht

Client-Bibliotheken

Dünne Wrapper über der REST API. Sie senden Ihren Schlüssel mit, bauen jede Anfrage auf und wandeln Fehlerantworten in Exceptions um.

Sie benötigen keine. Die API besteht aus einer Handvoll einfacher JSON-Endpoints; eine Bibliothek spart Ihnen einen Nachmittag, kein Projekt. Falls Ihre Sprache nicht aufgelistet ist, enthält die REST-Referenz Copy-Paste-Beispiele.

REST API Referenz →
JavaScript
Node.js · Deno · Bun · npm
Installieren
npm install namegender

Kopieren fehlgeschlagen. Text auswählen und kopieren.

Verwendung
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']);

Kopieren fehlgeschlagen. Text auswählen und kopieren.

Command line
macOS · Linux · Windows · Node.js 18+
Installieren
npm install -g namegender

Kopieren fehlgeschlagen. Text auswählen und kopieren.

Verwendung
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

Kopieren fehlgeschlagen. Text auswählen und kopieren.

PHP
PHP 8.1+
Installieren
composer require namegender/namegender

Kopieren fehlgeschlagen. Text auswählen und kopieren.

Verwendung
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']);

Kopieren fehlgeschlagen. Text auswählen und kopieren.

Python
Python 3.9+
Installieren
pip install namegender-client

Kopieren fehlgeschlagen. Text auswählen und kopieren.

Verwendung
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"])

Kopieren fehlgeschlagen. Text auswählen und kopieren.

Ruby
Ruby 3.0+
Installieren
gem install namegender

Kopieren fehlgeschlagen. Text auswählen und kopieren.

Verwendung
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

Kopieren fehlgeschlagen. Text auswählen und kopieren.

Java
Java 17+ · JitPack
Installieren
<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>

Kopieren fehlgeschlagen. Text auswählen und kopieren.

Verwendung
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());

Kopieren fehlgeschlagen. Text auswählen und kopieren.

C# / .NET
.NET Standard 2.0 · .NET 8 · NuGet
Installieren
dotnet add package NameGender --version 0.6.0

Kopieren fehlgeschlagen. Text auswählen und kopieren.

Verwendung
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);

Kopieren fehlgeschlagen. Text auswählen und kopieren.

Go
Go 1.21+
Installieren
go get github.com/anpekesen/namegender-go@v0.7.0

Kopieren fehlgeschlagen. Text auswählen und kopieren.

Verwendung
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)

Kopieren fehlgeschlagen. Text auswählen und kopieren.

R
R 4.1+ · GitHub
Installieren
remotes::install_github('anpekesen/namegender-r', ref = 'v0.7.0')

Kopieren fehlgeschlagen. Text auswählen und kopieren.

Verwendung
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

Kopieren fehlgeschlagen. Text auswählen und kopieren.

PowerShell
Windows PowerShell 5.1 · PowerShell 7 · PowerShell Gallery
Installieren
Install-Module NameGender

Kopieren fehlgeschlagen. Text auswählen und kopieren.

Verwendung
$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

Kopieren fehlgeschlagen. Text auswählen und kopieren.

Rust
async · reqwest + rustls · crates.io
Installieren
cargo add namegender

Kopieren fehlgeschlagen. Text auswählen und kopieren.

Verwendung
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")

Kopieren fehlgeschlagen. Text auswählen und kopieren.

Benötigen Sie eine andere Sprache?

Teilen Sie uns mit, welche, und wir schauen sie uns an. Die API-Oberfläche ist klein genug, dass ein Community-Wrapper ein Wochenendprojekt ist, und wir werden es hier verlinken.

Support kontaktieren