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 ved fulde navn - OPDEL FORNAVN OG EFTERNAVN

Hvis du bruger et kombineret felt til fornavn og efternavn på din side, brug denne API til at udtrække delene:

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
full_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

Eksempler

Forespørgsel kun efter fulde navn
play_arrow Test live med codepen.io 
{"full_name":"Theresa Miller"}
Forespørgsel efter fulde navn og landekode
play_arrow Test live med codepen.io 
{"full_name":"Theresa Miller","country":"US"}
Forespørgsel efter fulde navn og browserlandekode
play_arrow Test live med codepen.io 
{"full_name":"Thomas Johnson","locale":"en_US"}
Forespørgsel ved fuldt navn og brug en IP-adresse til lokalisering
play_arrow Test live med codepen.io 
{"full_name":"Markus Stefan NonExistingLastName","ip":"54.201.16.177"}
Forespørg flere navne i en enkelt forespørgsel
play_arrow Test live med codepen.io 
[{"full_name":"Theresa Miller"},{"full_name":"Thomas Johnson","country":"US"}]
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"
}
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.full_name_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
full_name string Det fulde navn 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