API Dokumentation Unified API v2.0

API v1.0

Vi tilbyder også en anden API-version med endpoints, der er lettere at integrere. Hvis du er nybegynder i at implementere API'er, kan du skifte til vores v1.0-endpoint.
Vis API v1.0

OpenAPI

Se vores API-dokumentation i Swagger

Postmand

Importér vores API-definition i Postman
Forespørgsel efter fornavn
Forespørgsel efter fulde navn
Forespørgsel efter e-mailadresse
Få oprindelsesland
Få Statistik
Fejlkoder

Forespørg efter emailadresse

Du kan også forespørge et køn ved hjælp af en email adresse, der indeholder en email adresse:

Send
Påkrævede forespørgsler: 1
URL
https://gender-api.io/v2/gender
Headers
Content-Type: application/json
Authorization: Bearer <din autorisationstoken>
link
JSON Payload
Felt Type Påkrævet Beskrivelse
email string Ja E-mailadresse til forespørgsel
country string Nej ISO 3166 ALPHA-2 Landekode
link
locale string Nej Browserens lokalitet
ip string Nej Gyldig IPv4- eller IPv6-adresse
id string Nej Maks 50 tegn. Du kan sætte denne id til en hvilken som helst alfanumerisk værdi, du ønsker. Som et eksempel kan du sætte id´et til din interne id af datasættet i din database. I et asynkront miljø kan dette hjælpe dig med bedre at forbinde svaret til en tidligere forespørgsel

Eksempler

Forespørg kun ved hjælp af email adresse
play_arrow Test live med codepen.io 
{"email":"theresa.miller14@gmail.com"}
Forespørg ved hjælp af email adresse og landekode
play_arrow Test live med codepen.io 
{"email":"thomas.clarks@hotmail.com","country":"US"}
Forespørg ved hjælp af email adresse og browser lokalitet
play_arrow Test live med codepen.io 
{"email":"Thomas.j32@live.com","locale":"en_US"}
Forespørg ved hjælp af email adresse og brug en IP adresse til lokalisation
play_arrow Test live med codepen.io 
{"email":"thomasfromnewyork@gmail.com","ip":"54.201.16.177"}
Forespørg flere navne i en enkelt forespørgsel
play_arrow Test live med codepen.io 
[{"email":"thomas.clarks@hotmail.com","country":"US"},{"email":"theresa.miller14@gmail.com"}]
Svar
{
    "input": {
        "email": "theresa.miller14@gmail.com"
    },
    "details": {
        "credits_used": 1,
        "duration": "12ms",
        "samples": 8961,
        "country": null,
        "first_name_sanitized": "theresa"
    },
    "result_found": true,
    "last_name": "Miller",
    "first_name": "Theresa",
    "probability": 0.98,
    "gender": "female"
}
Felt Type Beskrivelse
input object Den indsendte payload
details.credits_used int Antal forespørgsler brugt til denne forespørgsel
details.samples int Antal poster fundet i vores database, der matcher din anmodning
details.country string Landet vi fandt
details.email_sanitized int Navnet efter vi anvendte vores normalizer på det
details.duration string Tid serveren havde brug for til at behandle anmodningen
result_found bool Sandt hvis vi var i stand til at forespørge et køn for det givne navn
email string E-mailadressen vi brugte til kønsbestemmelse
probability float Denne værdi (mellem 0 og 1) bestemmer pålideligheden af vores database. En værdi på 1 betyder, at resultaterne på din forespørgsel om køn er 100 % nøjagtige.
gender string Mulige værdier: mand, kvinde, ukendt
Dette produkt inkluderer GeoLite2-data oprettet af MaxMind, tilgængelig fra http://www.maxmind.com.
Chat