Kommandolinjeklient
Nuværende version: v1.0.4
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
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.
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.
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.
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