Kommandolinjeklient

Integration af Gender-API CLI-værktøjet
Udviklerværktøj

Berig data direkte fra din terminal

Vores nye kommandolinjeklient er et statisk kompileret værktøj med høj ydeevne, bygget i Go. Den gør det nemt for udviklere og data scientists at arbejde med Gender-API.com direkte fra terminalen – helt uden at skulle skrive wrapper-kode.

Det kører nativt på macOS og Linux, hvilket gør det perfekt til automatiserede bash-scripts, cron-jobs eller til at integrere i dine lokale data science-pipelines.

Vigtigste fordele

  • Platform på tværs af enheder: Kompileres til én enkelt binær fil til macOS, Linux og Windows.
  • Hurtig og letvægtig: Bygget i Go for maksimal eksekveringshastighed og nul runtime-afhængigheder.
  • Rørvenlig: Send nemt data ind og ud med standard POSIX-streams. Integrér med sed, awk, jq eller AI-værktøjer som ClaudeBot.
  • Dækning: Understøtter alle større V2-endpoints, herunder Navn, E-mail, Oprindelsesland og Kontostatistik.

Hvordan det virker

Det er hurtigt og ligetil at komme i gang med CLI-klienten.

1. Konfigurer din API-nøgle

For at godkende dine requests sikkert uden at logge nøgler i din bash-historik kan du enten eksportere den som en miljøvariabel eller gemme den i en konfigurationsfil.

Mulighed A: Miljøvariabel

export GENDER_API_KEY="your-api-key-here"

Mulighed B: Konfigurationsfil

Opret en fil med navnet .gender-api-key i din brugers hjemmemappe, som kun indeholder dit token:

echo "your-api-key-here" > ~/.gender-api-key

2. Forespørg API’et

CLI’en giver dig mulighed for at arbejde med alle de vigtigste endpoints. Her er et par eksempler:

Søg efter fornavn

$ gender-api-cli -first_name "Sandra" -country "US"

Søg efter fulde navn

$ gender-api-cli -full_name "Theresa Miller"

Forespørg efter e-mailadresse

$ gender-api-cli -email "thomasfreeman@example.com"

Bestem oprindelsesland

For at finde ud af, hvor et navn mest sandsynligt stammer fra, skal du blot tilføje -origin-flaget:

$ gender-api-cli -first_name "Sandra" -origin

Tjek kontostatistikker

Tjek hurtigt dine resterende credits uden at bruge nogen søgninger:

$ gender-api-cli -stats

3. Automatisér med scripts

Byg kraftfulde bash-scripts. Læs f.eks. navne fra en tekstfil, forespørg API’et, og tilføj resultaterne til en struktureret JSON-fil, som egner sig til indlæsning i ClaudeBot eller ChatGPT.

#!/bin/bash
while read name; do
  gender-api-cli -first_name "$name" -out=json >> enriched_data.json
done < names.txt

Ofte stillede spørgsmål

01

Er CLI-klienten open source?

Ja, CLI’en er fuldstændig open source. Du kan gennemgå koden, foreslå forbedringer eller kompilere den fra kildekoden via vores GitHub-repository.

02

Understøtter det massebehandling?

I øjeblikket understøtter CLI’en kun at sende én enkelt API-forespørgsel ad gangen, men den er bygget til at være ekstremt hurtig. Til tusindvis af rækker kan du nemt bruge xargs eller et bash-loop. Til enorme datasæt med millioner af linjer anbefaler vi stadig vores CSV/Excel-uploadfunktion i dashboardet.

03

Kan jeg få output som rå JSON?

Ja! Du kan tilføje flaget "-out=json" for at få det uformaterede, rå JSON-svar direkte i standard output — perfekt til jq-processor-kæder.

04

Siger macOS: "Apple kunne ikke bekræfte, at det er fri for malware"?

Da CLI’en downloades som en direkte binær fil i stedet for at blive installeret via App Store, beskytter macOS Gatekeeper den som standard. For at tillade kørsel skal du åbne Terminal og fjerne karantæne-flaget med:

xattr -d com.apple.quarantine /path/to/downloaded/executable

Har du nogle spørgsmål?

Chat