Continuer → Aperçu

Bibliothèques client

De minces wrappers sur l'API REST. Ils envoient votre clé, construisent chaque requête et transforment les réponses d'erreur en exceptions.

Vous n'en avez pas besoin. L'API se résume à quelques endpoints en JSON simple ; une bibliothèque vous fait gagner un après-midi, pas un projet. Si votre langage n'est pas listé, la référence REST contient des exemples à copier-coller.

Référence API REST →
JavaScript
Node.js · Deno · Bun · npm
Installer
npm install namegender

Échec de la copie. Sélectionnez et copiez le texte.

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

Échec de la copie. Sélectionnez et copiez le texte.

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

Échec de la copie. Sélectionnez et copiez le texte.

Utilisation
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

Échec de la copie. Sélectionnez et copiez le texte.

PHP
PHP 8.1+
Installer
composer require namegender/namegender

Échec de la copie. Sélectionnez et copiez le texte.

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

Échec de la copie. Sélectionnez et copiez le texte.

Python
Python 3.9+
Installer
pip install namegender-client

Échec de la copie. Sélectionnez et copiez le texte.

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

Échec de la copie. Sélectionnez et copiez le texte.

Ruby
Ruby 3.0+
Installer
gem install namegender

Échec de la copie. Sélectionnez et copiez le texte.

Utilisation
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

Échec de la copie. Sélectionnez et copiez le texte.

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

Échec de la copie. Sélectionnez et copiez le texte.

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

Échec de la copie. Sélectionnez et copiez le texte.

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

Échec de la copie. Sélectionnez et copiez le texte.

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

Échec de la copie. Sélectionnez et copiez le texte.

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

Échec de la copie. Sélectionnez et copiez le texte.

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

Échec de la copie. Sélectionnez et copiez le texte.

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

Échec de la copie. Sélectionnez et copiez le texte.

Utilisation
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

Échec de la copie. Sélectionnez et copiez le texte.

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

Échec de la copie. Sélectionnez et copiez le texte.

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

Échec de la copie. Sélectionnez et copiez le texte.

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

Échec de la copie. Sélectionnez et copiez le texte.

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

Échec de la copie. Sélectionnez et copiez le texte.

Besoin d'un autre langage ?

Dites-nous lequel et nous l'examinerons. La surface API est assez petite pour qu'un wrapper communautaire soit un travail de fin de semaine, et nous le lierons ici.

Contacter le support