API-dokumentation Enhetlig API v2.0

API v1.0

Vi erbjuder också en annan version av API med endpoints som är lättare att integrera. Om du är nybörjare på att implementera API:er kan du byta till vår v1.0 endpoint.

Sök via e-postadress

Du kan också fråga om ett kön med en e-postadress som innehåller en e-postadress:

Skicka
Nödvändiga förfrågningar: 1
URL
https://gender-api.io/v2/gender
Headers
Content-Type: application/json
Authorization: Bearer <din auktoriseringstoken>
link
JSON Payload
Fält Typ Obligatorisk Beskrivning
email string Ja E-postadress för förfrågan
country string Nej ISO 3166 ALPHA-2 landskod
link
locale string Nej Webbläsarinställning
ip string Nej Giltig IPv4- eller IPv6-adress
id string Nej Max 50 tecken. Du kan ange detta id till vilket alfanumeriskt värde du vill. Som ett exempel kan du ange id till ditt interna id för datasetet i din databas. I en asynkron miljö kan detta hjälpa dig att bättre koppla svaren till en tidigare förfrågan

Exempel

Fråga endast med e-postadress
{"email":"theresa.miller14@gmail.com"}
Fråga med e-postadress och landskod
{"email":"thomas.clarks@hotmail.com","country":"US"}
Fråga med e-postadress och webbläsarens lokalisering
{"email":"Thomas.j32@live.com","locale":"en_US"}
Fråga med e-postadress och använd en IP-adress för lokalisering
{"email":"thomasfromnewyork@gmail.com","ip":"54.201.16.177"}
Fråga flera namn i en enda förfrågan
[{"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"
}
Fält Typ Beskrivning
input object Den inskickade nyttolasten
details.credits_used int Antalet förfrågningar som använts för denna fråga
details.samples int Antal poster som hittats i vår databas som matchar din förfrågan
details.country string Landet vi hittade
details.email_sanitized int Namnet efter att vi applicerat vår normaliserare på det
details.duration string Tiden servern behövde för att behandla begäran
result_found bool Sant om vi kunde fråga ett kön för det angivna namnet
email string E-postadressen vi använde för genusbestämning
probability float Denna värde (mellan 0 och 1) bestämmer tillförlitligheten i vår databas. Ett värde av 1 innebär att resultaten på din könsförfrågan är 100% korrekta.
gender string Möjliga värden: man, kvinna, okänd
Den här produkten inkluderar GeoLite2-data skapad av MaxMind, tillgänglig från http://www.maxmind.com.
Chatt