Dokumentacja API Unified API v2.0

API v1.0

Oferujemy także inną wersję naszego interfejsu API z punktami końcowymi, które są łatwiejsze do zintegrowania. Jeśli dopiero zaczynasz implementować API, możesz przełączyć się na nasz punkt końcowy v1.0.
Zobacz API v1.0

OpenAPI

Zobacz naszą dokumentację API w Swaggerze

Postman

Zaimportuj naszą definicję API do Postmana
Zapytanie według imienia
Zapytanie według pełnego imienia
Zapytanie według adresu e-mail
Pochodzenie kraju
Pobierz statystyki
Kody błędów

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:

Wyślij
Wymagane żądania: 1
URL
https://gender-api.com/v2/gender
Headers
Content-Type: application/json
Authorization: Bearer <twój token autoryzacyjny>
link
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

Przykłady

Zapytanie tylko po pełnej nazwie
play_arrow Testuj na żywo na codepen.io 
{"full_name":"Theresa Miller"}
Zapytanie po pełnej nazwie i kodzie kraju
play_arrow Testuj na żywo na codepen.io 
{"full_name":"Theresa Miller","country":"US"}
Zapytanie po pełnej nazwie i języku przeglądarki
play_arrow Testuj na żywo na codepen.io 
{"full_name":"Thomas Johnson","locale":"en_US"}
Zapytaj o pełne imię i nazwisko oraz użyj adresu IP do lokalizacji
play_arrow Testuj na żywo na codepen.io 
{"full_name":"Markus Stefan NonExistingLastName","ip":"54.201.16.177"}
Zapytaj o wiele nazw w jednym żądaniu
play_arrow Testuj na żywo na codepen.io 
[{"full_name":"Theresa Miller"},{"full_name":"Thomas Johnson","country":"US"}]
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"
}
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
Ten produkt zawiera dane GeoLite2 utworzone przez firmę MaxMind, dostępne z http://www.maxmind.com.
Czat