Wyślij
Wymagane żądania: 1
URL |
https://gender-api.com/v2/gender
|
Headers |
Content-Type: application/json
|
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
{"full_name":"Theresa Miller"}
Zapytanie po pełnej nazwie i kodzie kraju
{"full_name":"Theresa Miller","country":"US"}
Zapytanie po pełnej nazwie i języku przeglądarki
{"full_name":"Thomas Johnson","locale":"en_US"}
Zapytaj o pełne imię i nazwisko oraz użyj adresu IP do lokalizacji
{"full_name":"Markus Stefan NonExistingLastName","ip":"54.201.16.177"}
Zapytaj o wiele nazw w jednym żądaniu
[{"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 |