⚡ Unified API v2.0 AVANCERET

API-DOKUMENTATION

Oplev vores højtydende, samlede API udviklet til avancerede brugere med høje forespørgselsmængder. Forespørg flere navne i én enkelt anmodning med lynhurtige svartider.

Forespørgsel efter fornavn

Dette er den nemmeste måde at forespørge køn ud fra et navn. Hvert svar er JSON-kodet:

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

info Påkrævede forespørgsler: 1

http Headers

Content-Type: application/json

Authorization: Bearer <din autorisationstoken>

link

data_object JSON Payload

Felt	Type	Påkrævet	Beskrivelse
`first_name`	string	Ja	Navn at forespørge
`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

code Eksempler på forespørgsler

arrow_forward Forespørgsel efter fornavn alene

play_arrow Prøv live på Codepen.io

{
    "first_name": "Sandra"
}

arrow_forward Forespørgsel efter fornavn og landekode

play_arrow Prøv live på Codepen.io

{
    "first_name": "Sandra",
    "country": "US"
}

arrow_forward Forespørgsel efter fornavn og browserens lokalitet

play_arrow Prøv live på Codepen.io

{
    "first_name": "Sandra",
    "locale": "en_US"
}

arrow_forward Forespørgsel efter fornavn og brug en IP-adresse til lokalitet

play_arrow Prøv live på Codepen.io

{
    "first_name": "Sandra",
    "ip": "54.201.16.177"
}

arrow_forward Forespørg flere navne i en enkelt forespørgsel

play_arrow Prøv live på Codepen.io

[
    {
        "first_name": "Sandra",
        "country": "US"
    },
    {
        "first_name": "Jason",
        "country": "US"
    }
]

check_circle Svar

{
    "input": {
        "first_name": "Sandra"
    },
    "details": {
        "credits_used": 1,
        "samples": 464,
        "country": null,
        "first_name_sanitized": "sandra",
        "duration": "436ms"
    },
    "result_found": true,
    "first_name": "Sandra",
    "probability": 0.85,
    "gender": "female"
}

list Svarfelter

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.first_name_sanitized`	string	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
`first_name`	string	Det første fornavn 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