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ørgsel efter fornavn

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

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

Eksempler

Forespørgsel efter fornavn alene
play_arrow Test live med codepen.io 
{"first_name":"Sandra"}
Forespørgsel efter fornavn og landekode
play_arrow Test live med codepen.io 
{"first_name":"Sandra","country":"US"}
Forespørgsel efter fornavn og browserens lokalitet
play_arrow Test live med codepen.io 
{"first_name":"Sandra","locale":"en_US"}
Forespørgsel efter fornavn og brug en IP-adresse til lokalitet
play_arrow Test live med codepen.io 
{"first_name":"Sandra","ip":"54.201.16.177"}
Forespørg flere navne i en enkelt forespørgsel
play_arrow Test live med codepen.io 
[{"first_name":"Sandra","country":"US"},{"first_name":"Jason","country":"US"}]
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"
}
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
Dette produkt inkluderer GeoLite2-data oprettet af MaxMind, tilgængelig fra http://www.maxmind.com.
Chat