⚡ Enhetligt API v2.0 AVANCERAD

API-DOKUMENTATION

Upplev vårt högpresterande enhetliga API, utformat för avancerade användare med hög förfrågningsvolym. Fråga efter flera namn i en enda förfrågan med blixtsnabba svarstider.

Fråga med fullt namn - DELA FÖRNAMN OCH EFTERNAMN

Om du använder ett kombinerat fält för för- och efternamn på din sida, använd denna API för att extrahera delarna:

POST https://gender-api.com/v2/gender

info Nödvändiga förfrågningar: 1

http Headers

Content-Type: application/json

Authorization: Bearer <din auktoriseringstoken>

link

data_object JSON Payload

Fält	Typ	Obligatorisk	Beskrivning
`full_name`	string	Ja	Namn att fråga
`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

code Exempel på förfrågningar

arrow_forward Fråga endast med fullständigt namn

play_arrow Prova live på Codepen.io

{
    "full_name": "Theresa Miller"
}

arrow_forward Fråga med fullständigt namn och landskod

play_arrow Prova live på Codepen.io

{
    "full_name": "Theresa Miller",
    "country": "US"
}

arrow_forward Fråga med fullständigt namn och webbläsarens lokalisering

play_arrow Prova live på Codepen.io

{
    "full_name": "Thomas Johnson",
    "locale": "en_US"
}

arrow_forward Fråga efter fullständigt namn och använd en IP-adress för lokalisering

play_arrow Prova live på Codepen.io

{
    "full_name": "Markus Stefan NonExistingLastName",
    "ip": "54.201.16.177"
}

arrow_forward Fråga flera namn i en enda förfrågan

play_arrow Prova live på Codepen.io

[
    {
        "full_name": "Theresa Miller"
    },
    {
        "full_name": "Thomas Johnson",
        "country": "US"
    }
]

check_circle Svar

{
    "input": {
        "full_name": "Theresa Miller"
    },
    "details": {
    "credits_used": 1,
        "duration": "33ms",
        "samples": 8961,
        "country": null,
        "first_name_sanitized": "theresa"
    },
    "result_found": true,
    "last_name": "Miller",
    "first_name": "Theresa",
    "probability": 0.98,
    "gender": "female"
}

list Svarsfält

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.full_name_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
`full_name`	string	Det fullständiga namnet vi använde för könsbestä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