Wyślij
Wymagane żądania: 2
| URL |
https://gender-api.com/v2/country-of-origin
|
| Headers |
Content-Type: application/json
|
| JSON Payload |
| Pole |
Typ |
Wymagane |
Opis |
| first_name |
string |
Tak |
Imię do wyszukania |
| full_name |
string |
Nie |
Pełne imię i nazwisko do sprawdzenia. Można podać zamiast pola first_name |
| email |
string |
Nie |
Adres e-mail, który można podać zamiast pola "imię" |
| 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 poprzez imię
{"first_name":"Johann"}
Zapytania według pełnego nazwiska
{"full_name":"Theresa Miller"}
Wyszukaj po adresie e-mail
{"full_name":"sophia5342@gmail.com"}
Odpowiedź
{
"input": {
"first_name": "Johann",
"id": 12
},
"details": {
"credits_used": 2,
"duration": "414ms",
"samples": 890,
"country": null,
"first_name_sanitized": "johann"
},
"result_found": true,
"country_of_origin": [
{
"country_name": "Germany",
"country": "DE",
"probability": 0.52,
"continental_region": "Europe",
"statistical_region": "Western Europe"
},
{
"country_name": "Austria",
"country": "AT",
"probability": 0.48,
"continental_region": "Europe",
"statistical_region": "Western Europe"
}
],
"first_name": "Johann",
"probability": 0.9,
"gender": "male",
"language_of_origin": "Germanic",
"meaning": "Johann is the German variation of the name John, which means 'God is gracious'. It was frequently used in the Middle Ages across Europe, particularly as a name for religious figures.",
"ethnicity": {
"id": "GERMANIC",
"name": "Germanic (German, Austrian, Swiss)",
"distribution": [
{
"id": "GERMANIC",
"name": "Germanic (German, Austrian, Swiss)",
"percentage": 90
},
{
"id": "DUTCH",
"name": "Dutch",
"percentage": 5
},
{
"id": "FRENCH",
"name": "French",
"percentage": 5
}
]
}
}
| 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.first_name_sanitized |
string |
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 |
| country_of_origin_map_url |
string |
URL do interaktywnej mapy związanej z tym imieniem |
| first_name |
string |
Imię, które było użyte do określenia płci |
| probability |
float |
Ta wartość (między 0 a 1) określa wiarygodność naszej bazy danych. Wartość 1 oznacza, że wyniki dotyczące płci są 100% dokładne |
| gender |
string |
Możliwe wartości: mężczyzna, kobieta, nieznana |
| country_of_origin |
object |
Top 25 krajów pochodzenia. Zobacz "Pełną Listę Możliwych Krajów" dla listy obsługiwanych krajów. Każdy rekord zawiera pola country_name, country, probability, continental_region i statistical_region |
| language_of_origin |
string |
Język pochodzenia tego imienia |
| meaning |
string |
Krótki opis znaczenia tego imienia |
| ethnicity |
object |
Pole "etniczność" dostarcza szczegółów na temat głównej grupy etnicznej związanej z imieniem, a także jak imię jest rozłożone pomiędzy różne grupy etniczne |
| ethnicity.id |
string |
Pole id zawiera identyfikator określonej głównej grupy etnicznej. Zobacz "Kompletną listę możliwych grup etnicznych" dla pełnej listy możliwych grup etnicznych |
| ethnicity.name |
string |
Pole zawiera nazwę określonej głównej grupy etnicznej. Zobacz "Kompletna lista możliwych grup etnicznych" dla pełnej listy możliwych grup etnicznych |
| ethnicity.distribution |
array |
Pole Distribution zawiera informacje na temat proporcji imienia w różnych grupach etnicznych. Każdy wpis w tablicy zawiera pola id (tekst), name (tekst) i percentage (liczba rzeczywista). Zobacz "Kompletną Listę Możliwych Grup Etnicznych" aby uzyskać pełną listę możliwych wartości |