⚡ Ujednolicone API v2.0 ZAAWANSOWANE

DOKUMENTACJA API

Wypróbuj nasze wysokowydajne, ujednolicone API stworzone dla zaawansowanych użytkowników z dużą liczbą zapytań. Odpytuj wiele imion w jednym żądaniu z błyskawicznym czasem odpowiedzi.

Zapytania według pełnego nazwiska - ROZDZIEL IMIĘ I NAZWISKO

Jeżeli używasz połączonego pola na swojej stronie, aby wprowadzić imię i nazwisko, użyj tego API do wyodrębnienia części:

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

info Wymagane żądania: 1

http Headers

Content-Type: application/json

Authorization: Bearer <twój token autoryzacyjny>

link

data_object JSON Payload

Pole	Typ	Wymagane	Opis
`full_name`	string	Tak	Imię do zapytania
`country`	string	Nie	Kod kraju ISO 3166 ALPHA-2 link
`locale`	string	Nie	Lokalizacja przeglądarki
`ip`	string	Nie	Poprawny adres IPv4 lub IPv6
`id`	string	Nie	Maksymalnie 50 znaków. Id może być ustawione na dowolną alfanumeryczną wartość. Na przykład możesz ustawić id na swoje wewnętrzne id zbioru danych w bazie danych. W asynchronicznym środowisku może to pomóc w lepszym połączeniu odpowiedzi z poprzednim żądaniem

code Przykładowe żądania

arrow_forward Zapytanie tylko po pełnej nazwie

play_arrow Wypróbuj na żywo w Codepen.io

{
    "full_name": "Theresa Miller"
}

arrow_forward Zapytanie po pełnej nazwie i kodzie kraju

play_arrow Wypróbuj na żywo w Codepen.io

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

arrow_forward Zapytanie po pełnej nazwie i języku przeglądarki

play_arrow Wypróbuj na żywo w Codepen.io

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

arrow_forward Zapytaj o pełne imię i nazwisko oraz użyj adresu IP do lokalizacji

play_arrow Wypróbuj na żywo w Codepen.io

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

arrow_forward Zapytaj o wiele nazw w jednym żądaniu

play_arrow Wypróbuj na żywo w Codepen.io

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

check_circle Odpowiedź

{
    "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 Pola odpowiedzi

Pole	Typ	Opis
`input`	object	Wysłany payload
`details.credits_used`	int	Ilość użytych zapytań dla tej zapytania
`details.samples`	int	Liczba rekordów znalezionych w naszej bazie danych, które pasują do twojego zapytania
`details.country`	string	Znalezione przez nas kraj
`details.full_name_sanitized`	int	Imię po zastosowaniu normalizacji
`details.duration`	string	Czas potrzebny serwerowi na przetworzenie zapytania
`result_found`	bool	Prawda jeżeli byliśmy w stanie uzyskać informacje o płci na podstawie podanego imienia
`full_name`	string	Pełne imię, które użyliśmy do określenia płci
`probability`	float	Ta wartość (między 0 a 1) określa wiarygodność naszej bazy danych. Wartość 1 oznacza, że wynik twojego zapytania o płeć jest w 100% dokładny.
`gender`	string	Możliwe wartości: mężczyzna, kobieta, nieznana