Question 1

Co się dzieje, gdy imię może być zarówno męskie, jak i żeńskie?

Accepted Answer

W zależności od wersji API lub używanej integracji nasze endpointy zwracają w odpowiedzi wartość dokładności (accuracy) albo prawdopodobieństwa. Parametr dokładności mówi, jak bardzo jesteśmy pewni, że dane imię jest męskie albo żeńskie. Wartość obliczamy na podstawie liczby rekordów w naszej bazie danych. Na przykład jeśli mamy 100 próbek imienia, z czego 96 to kobiety, a 4 to mężczyźni, dokładność wynosi 96% (czyli prawdopodobieństwo 0,96). Niska dokładność oznacza, że imię jest prawdopodobnie używane przez obie płcie i nie da się jednoznacznie przypisać go do jednej z nich.

Question 2

Czy może występować różnica dla tego samego imienia między krajami?

Accepted Answer

Imię Andrea jest męskie we Włoszech, w Niemczech jest żeńskie, a w USA może być jedno i drugie.
W takim przypadku w wyniku zapytania podajemy wartość dokładności w zakresie od 0 do 100 (albo prawdopodobieństwo między 0 a 1). Mówi ona, na ile jesteśmy pewni, że rozpoznaliśmy właściwą płeć. Jakość wyników API możesz znacznie poprawić, podając informacje geograficzne przy zapytaniu. Może to być kod kraju, ustawienia regionalne przeglądarki albo adres IP. Więcej o lokalizowaniu zapytań znajdziesz w naszej dokumentacji API.

Question 3

Jak zbieracie dane?

Accepted Answer

Aby zapewnić jak najwyższą dokładność, łączymy dane z wielu źródeł. Głównymi źródłami nowych rekordów są dane publicznie dostępne, dane rządowe oraz ręczne uzupełnienia i korekty.
W zależności od źródła nowe imię może wymagać potwierdzenia przez drugie źródło, zanim trafi na naszą listę. Na przykład imię pochodzące ze źródła publicznego może wymagać drugiej weryfikacji, np. ręcznego potwierdzenia, zanim ostatecznie dodamy je do naszej bazy danych.
Listę obsługiwanych krajów znajdziesz tutaj.

Question 4

Jak często aktualizujecie rekordy z imionami?

Accepted Answer

Regularnie aktualizujemy nasze dane – w zależności od kraju i dostępności danych publicznych. Większość krajów zachodnich aktualizujemy raz w roku. Poza tym rozkład imion pomiędzy płciami może zmieniać się z upływem lat. Na przykład imię, które w latach 70. XX wieku nosiły wyłącznie kobiety, kilka dekad później może być nadawane głównie mężczyznom. Dlatego dla kilku krajów, na przykład dla USA, korzystamy dodatkowo z danych o urodzeniach, aby wzbogacić wyniki. Nasze modele starają się uwzględnić wszystkie te czynniki tak dobrze, jak to możliwe.
Zwracaną wartość dokładności regularnie korygujemy, aby jak najwierniej odzwierciedlała rzeczywiste użycie imienia w populacji. Wartość ma dać rozsądną ocenę opartą na ostatnich dekadach i może wyrażać możliwe wahania. Analizujemy około czterech ostatnich dekad danych.
Jeśli powtórzysz to samo zapytanie rok później, możesz otrzymać inny wynik, ponieważ nasz system mógł usunąć stare dane, a nowe mogły zostać dodane.
Za każdym razem, gdy dodajemy nowe dane, przeprowadzamy tak zwane testy integracyjne. W ich trakcie nasze API jest sprawdzane na wcześniej zweryfikowanym zbiorze danych, co pozwala nam pilnować jakości. Ten zbiór stale rozbudowujemy o nowe imiona i przypadki testowe, aby osiągnąć jak najszersze pokrycie.

Question 5

Jak wykorzystujecie sztuczną inteligencję (AI)?

Accepted Answer

Sztuczną inteligencję (AI) wykorzystujemy codziennie do poprawy jakości naszej bazy danych i wyników API. Dzięki AI możemy sprawnie i dokładnie dodawać nowe wpisy do bazy, tak aby nasze informacje były zawsze aktualne.

AI odgrywa też kluczową rolę w poprawie ogólnej jakości wyników naszego API. Korzystając z algorytmów uczenia maszynowego, możemy skuteczniej analizować dane, rozpoznawać wzorce i dostarczać naszym użytkownikom dokładniejsze i trafniejsze wyniki.

Question 6

Czy pomagacie we wdrożeniu API?

Accepted Answer

Tak, wszystkim klientom zapewniamy wsparcie e-mailowe. Napisz do nas na adres contact gender-api.com, a odpowiemy tak szybko, jak to możliwe. Przykłady kodu znajdziesz tutaj.
Pamiętaj, że nie jesteśmy w stanie pomóc w każdym języku programowania i w każdym przypadku użycia. W większości sytuacji wystarczy standardowy klient REST w Twojej aplikacji, aby wysyłać żądania do naszego API. Wiele bibliotek obsługuje też import pliku definicji OpenAPI. Nasz plik openapi.yml możesz pobrać tutaj.

Question 7

Co, jeśli potrzebujemy wysokiego poziomu dokładności?

Accepted Answer

Języki i imiona są płynne i zmieniają się z czasem. U różnych klientów zbiory danych bardzo się też różnią jakością, zakresem i pochodzeniem. Dlatego nie możemy zagwarantować, że wszystkie wyniki, które otrzymasz z naszego API, są w 100% poprawne i pasują do Twojego zbioru danych. Możemy jednak obiecać, że zawsze staramy się dostarczać najlepsze możliwe wyniki i regularnie ulepszamy oraz aktualizujemy nasze algorytmy. Bardzo regularnie dodajemy też nowe dane. Więcej o naszych aktualizacjach znajdziesz tutaj. W tym mało prawdopodobnym przypadku, gdy nasza usługa nie spełni Twoich oczekiwań, dajemy Ci prostą 14-dniową gwarancję zwrotu pieniędzy.
Oczywiście oferujemy też całkowicie darmowy test naszej usługi. Jeśli zarejestrujesz się tutaj, otrzymasz bezpłatnie 100 żądań co miesiąc.
Gdy zapytasz o imię, nasze endpointy zwrócą w odpowiedzi wartość dokładności albo prawdopodobieństwa – w zależności od wersji API. Parametr dokładności mówi, jak bardzo jesteśmy pewni, że dane imię jest męskie albo żeńskie.
Wartość obliczamy na podstawie liczby rekordów w naszej bazie danych.
Ponieważ przypadki użycia bardzo się różnią, nie dajemy zaleceń co do poziomu dokładności. To od Ciebie zależy, jakie wyniki i poziomy dokładności akceptujesz.
Nawet przy dokładności co najmniej 99% wynik może być niepoprawny. Wartość powyżej 95% pasuje jednak zwykle do większości zastosowań.

Question 8

Ile imion macie w swojej bazie danych?

Accepted Answer

Nasza baza danych zawiera 6,084,389 zweryfikowanych imion z 191 różnych krajów. Na całym świecie przechowujemy 6,450,268 unikalnych imion.
Średnio analizujemy około 10 000 000 zestawów danych miesięcznie, aby poprawić jakość naszych wyników.

Question 9

Które kraje są obsługiwane?

Accepted Answer

API obsługuje w pełni 191 krajów. Pełne wsparcie oznacza, że zebraliśmy co najmniej  imion
w danym kraju. Jednak w większości krajów zbiór naszych danych jest znacznie większy. Spójrz na poniższą tabelę,
aby dowiedzieć się więcej o tym, ile imion obsługujemy w poszczególnych krajach. Pamiętaj, że jeśli nie zapewniamy odpowiedniego wsparcia dla danego kraju, 
wciąż możesz przeszukać żądane imiona w całym zbiorze danych, aby uzyskać odpowiedni wynik.

Question 10

Czy obsługujecie imiona arabskie?

Accepted Answer

Tak, nasze API obsługuje imiona arabskie. Mogą być zapisane również znakami alfabetu arabskiego.
Język arabski zapisuje się kursywą od prawej do lewej i ma 28 liter.
Na przykład jeśli zapytasz o „عبد ال“, otrzymasz taki wynik: "gender": "male", "accuracy": 100.
Imię arabskie "عبد ال" jest w tym przykładzie zakodowane w URL, a adres zapytania wyglądałby tak: https://gender-api.com/get?name=%D8%B9%D8%A8%D8%AF%20%D8%A7%D9%84&key=YOUR_API_KEY.
Pełną listę obsługiwanych krajów znajdziesz tutaj.

Question 11

Czy mogę zapytać o wiele imion w jednym żądaniu?

Accepted Answer

Tak, jak najbardziej. Możesz zapytać o maksymalnie 100 imion naraz.
Szczegóły znajdziesz w naszej dokumentacji API.

Question 12

Słyszałem o waszym API do e-maili. Czym ono dokładnie jest?

Accepted Answer

Nasze API e-mailowe potrafi wyodrębnić imię z adresu e-mail i przypisać do tego adresu odpowiednią płeć. Dzięki temu możesz personalizować wysyłki właściwym zwrotem grzecznościowym.
Na przykład z adresu "marie.johnson@gmail.com" API wyodrębni imię "Marie" i określi właściwą płeć, czyli "female".
Szczegóły znajdziesz w naszej dokumentacji API.

Question 13

Mam bardzo dużo danych. Czy mogę przesłać plik CSV zbiorczo?

Accepted Answer

Jako zarejestrowany użytkownik możesz przesłać dowolny plik CSV, który zawiera kolumnę z imionami.
Aby uzyskać lepszy wynik, możesz opcjonalnie dodać do zbioru kolumnę z krajem. Kolumn nie musisz specjalnie nazywać – nasz asystent przeprowadzi Cię przez cały proces i pozwoli wskazać, która kolumna zawiera imię, a która kraj.
Funkcję znajdziesz na swoim koncie. Przetworzone rekordy naliczamy tak jak żądania, więc każdego miesiąca możesz bezpłatnie przesłać plik CSV z maksymalnie 100 wpisami. Masowe przesyłanie plików CSV wymaga konta w Gender-API.com. Ze względu na ochronę danych przesłane pliki usuwamy automatycznie po roku.

Question 14

Jak powinien być sformatowany plik CSV?

Accepted Answer

Obsługujemy pliki CSV utworzone w systemach Windows, MacOS i Linux.
Obsługujemy też pliki z separatorem ";", "," lub tabulatorem. Znakiem cytowania musi być ".
Możesz przesłać wielowierszowe pliki CSV z maksymalnie 10 000 000 wierszy i o rozmiarze do 301MB.
Aby uzyskać najlepsze możliwe wyniki, zalecamy plik CSV w kodowaniu UTF-8 ze średnikiem jako separatorem.
Poza tym plik CSV może zawierać dowolne dodatkowe kolumny, które również znajdą się w pliku wynikowym.
Plik musi mieć co najmniej jedną kolumnę z samymi imionami albo kolumnę z pełnymi imionami i nazwiskami.
Kliknij tutaj, aby pobrać przykładowy plik. Aby przesłać plik CSV, utwórz konto w Gender-API.com.

Question 15

Czy mogę przesłać plik Excela?

Accepted Answer

Możesz przesyłać pliki Excel z maksymalnie 300 000 wierszy. Dla większych zbiorów danych skorzystaj z przesyłania plików CSV. Obsługujemy pliki .xlsx z jednym arkuszem. Jeśli prześlesz plik z więcej niż jednym arkuszem, przetworzymy tylko pierwszy.
Pierwszy wiersz arkusza musi zawierać nazwy kolumn. Plik musi zawierać co najmniej jedną kolumnę z imionami, kolumna z krajem jest opcjonalna. Ze względu na ochronę danych przesłane pliki usuwamy automatycznie po roku. Pobierz tutaj plik wzorcowy. Przykład:

Question 16

Znalazłem błąd. Co powinienem zrobić?

Accepted Answer

Bardzo cenimy Twoją pomoc. Napisz do nas na adres contact gender-api.com, a postaramy się naprawić ten błąd jak najszybciej.

Question 17

Czy Gender-API jest zgodne z Rozporządzeniem Ogólnym o Ochronie Danych (RODO)?

Accepted Answer

Wszystkie usługi Gender-API.com są w pełni zgodne z RODO. Udostępniamy Umowę Przetwarzania Danych (DPA), która umożliwia Ci spełnienie Twoich obowiązków związanych z RODO. Możesz poprosić o tę umowę tu na swoim koncie. Przykładową umowę można pobrać tu. Ponadto, można znaleźć więcej informacji, jak chronimy Twoje dane tu.

Question 18

Czy dostarczacie biblioteki do języków programowania?

Accepted Answer

Ze względu na prostotę naszego API nie udostępniamy bibliotek dla języków programowania – z wyjątkiem wtyczki jQuery. Większość języków obsługuje parser JSON domyślnie, a dla niemal każdego pozostałego istnieje już zewnętrzna biblioteka, której możesz użyć. Zajrzyj do naszych przykładów kodu, aby zacząć korzystać z API:

Question 19

Jak liczone są żądania?

Accepted Answer

Każde konto pierwszego dnia miesiąca doładujemy do 100 żądań, jeśli pozostało ich mniej.
Żądanie naliczamy tylko wtedy, gdy znaleźliśmy wynik. Jedno wyszukanie imienia liczy się jako jedno żądanie. Jeśli w jednym zapytaniu pytasz o wiele imion, każde imię liczymy jako osobne żądanie.

Question 20

Gdzie mogę znaleźć i zarządzać swoimi kluczami API?

Accepted Answer

Generujemy początkowy klucz API, gdy zarejestrujesz się na Gender-API.com. Możesz znaleźć ten klucz API na dole strony przeglądu Twojego konta. Jeśli chcesz unieważnić ten klucz, kliknij przycisk „Unieważnij i ponownie wygeneruj”. 
Nasz system unieważni istniejący klucz API i wygeneruje nowy. Wszystkie Twoje aplikacje, które korzystają ze starego tokena, nie będą mogły mieć dostępu do naszego API, dopóki nie zastąpisz tego kodu nowym kluczem API. [apiKeyImage] 
Możesz również utworzyć więcej niż jeden klucz API. Jest to przydatne, na przykład, jeśli masz wiele aplikacji, w których chcesz włączyć nasze API. Zauważ, że nie ma różnicy między kluczami a ilością żądań, które zostały zrealizowane. Wszystkie żądania są liczone łącznie. Aby zarządzać lub stworzyć wiele kluczy API, kliknij przycisk "Ustawienia" w menu konta, a następnie "Klucze API".

[multipleKeysImage] Klikając przycisk "Utwórz nowy klucz", możesz wygenerować nowy klucz API. Możesz nadać każdemu tokenowi nazwę, aby później łatwiej zidentyfikować, gdzie ten klucz został użyty. Nazwę można zmienić w każdej chwili. Ponadto, niektóre z naszych widżetów wygenerują tutaj automatycznie klucz. Na przykład, jeśli używasz na swoim koncie naszego "Szybkiego widżetu wyszukiwania", nasz system wygeneruje klucz z wyprzedzeniem, a następnie ten widżet będzie korzystał z tego tokenu, aby zapytać nasze API.

Ponadto, aplikacje podłączone przez osoby trzecie będą tworzyć tutaj klucz. Każdy token można w każdej chwili wycofać, klikając po prostu "x". Po wycofaniu, połączona aplikacja nie będzie już miała dostępu do naszego API.

Question 21

Czy mogę udostępnić moje konto kilku osobom?

Accepted Answer

Konto możesz udostępnić nawet 50 innym współpracownikom lub osobom związanym z Twoim projektem. Aby zarządzać zespołem, zaloguj się na swoje konto i w menu konta kliknij „Ustawienia” => „Zarządzaj swoim zespołem”.
Na tej stronie kliknij przycisk „Zaproś nowego użytkownika”, aby zaprosić do zespołu ludzi przez e-mail. Zapraszając członków zespołu, możesz wybrać jeden z dwóch typów konta.
A) Użytkownicy mogą przeglądać, tworzyć, aktualizować i usuwać klucze API, przesyłać pliki CSV i Excel oraz określać w nich płeć, korzystać ze wszystkich endpointów API, kupować żądania i łączyć aplikacje zewnętrzne. B) Administratorzy mogą to wszystko, a dodatkowo aktualizować ustawienia konta i adres rozliczeniowy, tworzyć i przeglądać umowy powierzenia przetwarzania danych oraz zapraszać, aktualizować i usuwać członków zespołu.

Question 22

Czy mogę zabezpieczyć swoje konto, włączając weryfikację dwuetapową?

Accepted Answer

Swoje konto możesz zabezpieczyć, włączając weryfikację dwuetapową. Aby włączyć to dodatkowe zabezpieczenie, zaloguj się na swoje konto i w menu konta kliknij „Ustawienia” => „Zmień hasło / 2FA”. Upewnij się, że masz na telefonie zainstalowaną aplikację uwierzytelniającą. Zalecamy Authy (App Store, Play Store) albo Google Authenticator (App Store, Play Store).
Następnie kliknij przycisk „Włącz teraz” i postępuj zgodnie z instrukcjami na ekranie. Możesz dodać tu kilka urządzeń, aby na przykład zachować dostęp do konta po utracie jednego z nich.
Po włączeniu weryfikacji dwuetapowej do zalogowania będzie potrzebny kod wygenerowany przez aplikację uwierzytelniającą na Twoim telefonie.

Question 23

Czy mogę używać aplikacji zewnętrznych, gdy włączona jest weryfikacja dwuetapowa?

Accepted Answer

Niektóre integracje i aplikacje zewnętrzne działają bez zarzutu przy włączonej weryfikacji dwuetapowej. Inne mogą wymagać połączenia bez niej. Jeśli masz problem z zalogowaniem się do jakiejś aplikacji danymi z Gender-API.com, zaloguj się bezpośrednio na swoje konto w Gender-API i w menu konta kliknij „Ustawienia” => „Zmień hasło / 2FA”. Następnie otwórz zakładkę „Weryfikacja dwuetapowa” i ustaw „Dostęp aplikacji zewnętrznych” na „Nieograniczony”.
Pamiętaj, że tę opcję możesz zmienić tylko wtedy, gdy weryfikacja dwuetapowa jest włączona.

Question 24

Czym są klucze dostępu (passkeys) i jak działają?

Accepted Answer

Klucze dostępu (passkeys) to nowoczesna metoda uwierzytelniania bez hasła, która daje większe bezpieczeństwo niż tradycyjne hasła.
Zamiast wpisywać hasło, możesz zalogować się wbudowanymi funkcjami bezpieczeństwa swojego urządzenia – Face ID, Touch ID, Windows Hello albo kodem PIN.
Klucze dostępu opierają się na standardzie WebAuthn i są odporne na phishing, bo są kryptograficznie powiązane z konkretną witryną.
Twój klucz prywatny nigdy nie opuszcza urządzenia, dlatego klucze dostępu są bezpieczniejsze niż hasła. Gdy skonfigurujesz klucz dostępu dla swojego konta Gender-API.com, zalogujesz się jednym dotknięciem lub spojrzeniem – bez hasła. Klucze dostępu działają na różnych urządzeniach i mogą być synchronizowane przez iCloud Keychain, Google Password Manager lub podobne usługi.

Question 25

Jak skonfigurować klucz dostępu dla swojego konta?

Accepted Answer

Klucz dostępu konfiguruje się automatycznie podczas logowania. Gdy zalogujesz się adresem e-mail i hasłem, zaproponujemy Ci utworzenie klucza dostępu, aby kolejne logowania były szybsze. Postępuj zgodnie ze wskazówkami na urządzeniu – przeglądarka poprosi Cię o potwierdzenie tożsamości przez Face ID, Touch ID, Windows Hello albo kod PIN urządzenia. Po potwierdzeniu klucz dostępu zapisze się automatycznie na Twoim urządzeniu i będzie gotowy do użycia. Przy kolejnej wizycie na Gender-API.com zalogujesz się natychmiast samym kluczem dostępu, bez wpisywania hasła.
Konfigurację klucza dostępu możesz pominąć, jeśli wolisz dalej korzystać z hasła.
Uwaga: klucze dostępu wymagają zgodnej przeglądarki (Chrome, Safari, Edge, Firefox) i systemu operacyjnego.

Question 26

Czym klucze dostępu różnią się od weryfikacji dwuetapowej (2FA)?

Accepted Answer

Oba rozwiązania zwiększają bezpieczeństwo, ale działają inaczej. Weryfikacja dwuetapowa (2FA) dodaje drugi czynnik po wpisaniu hasła – zwykle kod z aplikacji uwierzytelniającej. Klucze dostępu zastępują hasło całkowicie i zapewniają bezpieczeństwo wieloczynnikowe w jednym kroku, łącząc coś, co masz (Twoje urządzenie), z tym, kim jesteś (dane biometryczne) albo co wiesz (PIN urządzenia).
Klucze dostępu uważa się za bezpieczniejsze, ponieważ są odporne na phishing (działają tylko na prawdziwej witrynie), nie są narażone na wycieki baz haseł i nie da się ich odgadnąć ani złamać.
Jeśli masz włączone i klucze dostępu, i 2FA, zalogowanie się kluczem dostępu pominie monit 2FA, bo klucz zapewnia już równoważne lub wyższe bezpieczeństwo.

Question 27

Co się stanie, jeśli zgubię urządzenie z kluczem dostępu?

Accepted Answer

Jeśli zgubisz urządzenie z kluczem dostępu, nie martw się – Twoje konto jest nadal bezpieczne i dostępne.
Zawsze możesz zalogować się hasłem (i 2FA, jeśli je włączyłeś). Jeśli Twoje klucze dostępu są synchronizowane przez iCloud Keychain albo Google Password Manager, będą automatycznie dostępne na pozostałych urządzeniach zalogowanych na to samo konto.
Dla najlepszego bezpieczeństwa zalecamy: skonfigurować klucze dostępu na kilku urządzeniach, zachować hasło jako zapas i włączyć 2FA jako dodatkową warstwę ochrony. Możesz też zarządzać swoimi kluczami dostępu w ustawieniach konta, aby usunąć klucz zgubionego urządzenia i zapobiec nieuprawnionemu dostępowi.

Question 28

Jaka jest różnica między płatnym a bezpłatnym kontem?

Accepted Answer

Oba typy kont mają tę samą funkcjonalność. Wszystkie endpointy API są dostępne dla obu typów kont i zwracają takie same wyniki.
Konta darmowe mają ograniczoną liczbę żądań na miesiąc. Po rejestracji od razu masz do dyspozycji 100 darmowych żądań. Pierwszego dnia każdego miesiąca nasz system zeruje licznik i darmowe żądania są znów dostępne. Utwórz tylko jedno konto. Jeśli potrzebujesz więcej żądań, możesz w każdej chwili przejść na jeden z naszych płatnych planów tutaj.

Question 29

Jak mogę się wylogować ze wszystkich urządzeń?

Accepted Answer

Jeśli klikniesz przycisk wylogowania na swoim koncie, wylogujemy Cię tylko z bieżącego urządzenia.
Aby zapewnić bezpieczeństwo swojego konta i danych, w razie potrzeby warto wylogować się ze wszystkich urządzeń. Postępuj zgodnie z poniższymi instrukcjami, aby wylogować się ze wszystkich urządzeń na naszej platformie API.
Po zalogowaniu kliknij tutaj, aby wylogować się ze wszystkich urządzeń. Poza tym jeśli zmienisz hasło albo ustawienia uwierzytelniania dwuskładnikowego, system automatycznie wyloguje Cię ze wszystkich urządzeń, których adres IP nie zgadza się z Twoim aktualnym. To dodatkowa warstwa zabezpieczeń Twojego konta. Zalecamy tworzenie osobnych kont dla każdego członka zespołu – to bezpieczniejsze i wygodniejsze we współpracy.
Dodatkowo, aby zwiększyć bezpieczeństwo konta, zdecydowanie zalecamy włączenie uwierzytelniania dwuskładnikowego (2FA). Ta dodatkowa warstwa ochrony dodaje jeden krok do procesu logowania i utrudnia dostęp osobom nieupoważnionym.

Question 30

Jaka jest różnica między subskrypcją a jednorazową płatnością?

Accepted Answer

Jeśli chcesz kupić jeden z naszych pakietów, możesz wybrać między płatnością jednorazową a subskrypcją tego pakietu.
Subskrypcję zalecamy, jeśli chcesz korzystać z naszej usługi regularnie. Masz wtedy pewność, że na Twoim koncie zawsze zostaje wystarczająco dużo żądań.
Żądania kupione w ramach subskrypcji możesz wykorzystać w ciągu jednego miesiąca. Przy aktywnej subskrypcji nasz system po miesiącu doładuje Twoje konto do wybranej liczby żądań. Na przykład jeśli masz subskrypcję pakietu 25 000 żądań i wykorzystasz 21 500, po miesiącu nasz system uzupełni Twoje konto do 25 000 żądań.
Pakiety jednorazowe kupuje się pod jedno konkretne zastosowanie i możesz je wykorzystać w ciągu roku. Jeśli chcesz na przykład przetworzyć plik Excel albo CSV, zalecamy zakup jednorazowy.
Zakupy jednorazowe nie odnawiają się. Musisz sam pilnować, żeby żądania Ci nie skończyły.
Oba typy pakietów możesz zmieniać na naszej stronie zakupów.

[difference]
Nie łącz obu typów zakupu, dopóki nie porozmawiasz z naszym wsparciem albo nie wiesz dokładnie, co robisz. Zakup pakietu jednorazowego w czasie, gdy masz aktywną subskrypcję jednego z naszych pakietów, może sprawić, że subskrypcja nie uzupełni Twoich żądań – na przykład wtedy, gdy z zakupu jednorazowego zostało Ci więcej żądań, niż dołożyłaby subskrypcja.

Question 31

Potrzebuję certyfikatu rezydencji podatkowej. Czy możecie wystawić taki certyfikat?

Accepted Answer

Jeśli potrzebujesz certyfikatu rezydencji podatkowej naszej firmy, napisz w tej sprawie do naszego wsparcia. Certyfikat musimy zamówić indywidualnie dla każdej firmy. W zgłoszeniu podaj pełny adres swojej firmy, kraj rezydencji oraz, jeśli go masz, swój numer podatkowy. Certyfikat rezydencji musi podpisać nasz urząd skarbowy. Na podpisany dokument czeka się zwykle 2–3 tygodnie; potem możemy przekazać go jako skan cyfrowy.

[certificate-of-residence]

Question 32

Jak mogę kupić pakiet / więcej żądań?

Accepted Answer

Możesz wybrać plan subskrypcyjny albo płatność jednorazową tutaj.
Płatność jednorazową zalecamy, jeśli chcesz przetworzyć duży plik CSV albo wolisz korzystać z żądań nieregularnie. W dowolnym momencie możesz doładować konto potrzebną liczbą żądań. Żądania kupione w ramach płatności jednorazowej możesz wykorzystać w ciągu roku.
Jeśli wolisz subskrypcję, Twoje konto będzie co miesiąc doładowywane do wybranej liczby żądań. Subskrypcję możesz w każdej chwili zmienić albo anulować.

Question 33

Jak mogę anulować moją subskrypcję?

Accepted Answer

Możesz w każdej chwili zmienić lub anulować swoją subskrypcję tutaj. Jeśli chcesz zakończyć cykliczne płatności, kliknij przycisk „Anuluj subskrypcję”.

Question 34

Jaki jest typowy czas odpowiedzi API?

Accepted Answer

Nasze API jest zaprojektowane z myślą o wysokiej wydajności i zwykle odpowiada w ciągu 10–200 milisekund.
Czasy odpowiedzi mogą się nieznacznie różnić w zależności od Twojej lokalizacji geograficznej, warunków sieciowych i złożoności zapytania.
W przypadku żądań wsadowych z wieloma imionami czas odpowiedzi rośnie liniowo. Używamy globalnego CDN i zoptymalizowanej infrastruktury, aby zapewnić niskie opóźnienia na całym świecie. Jeśli odpowiedzi są u Ciebie stale wolne, napisz do naszego zespołu wsparcia.

Question 35

Czy obowiązują jakieś limity szybkości lub ograniczenia liczby żądań?

Accepted Answer

Stosujemy limity uczciwego korzystania, aby zapewnić optymalne działanie usługi wszystkim użytkownikom.
Konta darmowe mogą wykonać do 100 żądań miesięcznie. Konta płatne mają wyższe limity: 1500 żądań na minutę i brak ograniczeń dziennych, o ile masz dostępne kredyty.
Jeśli potrzebujesz wyższych limitów dla swojego zastosowania, skontaktuj się z nami, aby omówić indywidualny plan.
Żądania wsadowe (do 100 imion w jednym żądaniu) liczą się jako pojedyncze żądania, ale są wydajniejsze.

Question 36

Jaka jest wasza gwarancja dostępności API?

Accepted Answer

Gwarantujemy 99,9% dostępności API we wszystkich płatnych planach. Nasza infrastruktura działa na serwerach klasy enterprise z automatycznym przełączaniem awaryjnym i równoważeniem obciążenia. Nieprzerwanie monitorujemy nasze systemy 24/7 i mamy automatyczne alerty na wypadek problemów.
Klientom korporacyjnym zapewniamy również umowę o poziomie usług (SLA). W rzadkim przypadku dłuższej niedostępności klienci płatni otrzymują automatyczne kredyty serwisowe zgodnie z warunkami naszego SLA.

Question 37

W jakim formacie zwraca odpowiedź API?

Accepted Answer

Nasze API domyślnie zwraca odpowiedzi w formacie JSON, który obsługują wszystkie nowoczesne języki programowania. Każda odpowiedź zawiera zapytane imię, rozpoznaną płeć, wartość dokładności lub prawdopodobieństwa oraz dodatkowe metadane. Na przykład: {"name":"Maria","gender":"female","accuracy":99,"samples":12847,"country":"US"}.
Szczegółowe schematy odpowiedzi znajdziesz w naszej dokumentacji API, gdzie możesz też pobrać naszą specyfikację OpenAPI do automatycznego generowania klientów.

Question 38

Jak powinienem obsługiwać błędy API?

Accepted Answer

Nasze API używa standardowych kodów statusu HTTP, aby wskazać powodzenie lub błąd.
200 oznacza powodzenie, 401 nieprawidłowy klucz API, 429 przekroczenie limitu żądań, a 500 błąd serwera.
Każda odpowiedź z błędem zawiera opisowy komunikat i kod błędu, co ułatwia debugowanie.
Zalecamy zastosowanie wykładniczego wycofywania żądań (exponential backoff) przy błędach limitu oraz buforowanie udanych odpowiedzi, gdy to możliwe.
Jeśli błędy się powtarzają, zajrzyj do naszej dokumentacji API albo napisz do wsparcia.
Wszystkie błędy zapisujemy w logach do celów diagnostycznych.

Question 39

Jak obsługujecie wersjonowanie API?

Accepted Answer

Obecnie utrzymujemy dwie wersje API: V1 i V2. V2 jest naszą najnowszą wersją z rozszerzonymi funkcjami, w tym wartościami prawdopodobieństwa, rozszerzoną obsługą krajów i poprawioną dokładnością. V1 pozostaje dostępna ze względu na kompatybilność wsteczną, ale zalecamy przejście na V2 dla nowych integracji. Wszystkie endpointy API zawierają wersję w ścieżce URL (np. /v2/name). Gwarantujemy, że starsze wersje API nadal będą działać. Przewodniki migracyjne są dostępne w naszej dokumentacji API. O wszystkich zmianach niezgodnych wstecz informujemy z dużym wyprzedzeniem.

Question 40

Jak radzicie sobie z różnymi wariantami imion i zdrobnieniami?

Accepted Answer

Nasza baza danych zawiera popularne warianty imion, zdrobnienia i przezwiska. Na przykład „Bob” rozpoznajemy jako wariant imienia „Robert”, a „Liz” jako wariant „Elizabeth”. Dla najlepszej dokładności zalecamy jednak pytanie o pełne imię, jeśli je znasz. Nasze systemy AI nieustannie uczą się nowych wariantów imion z naszego zbioru danych. Jeśli trafisz na przezwisko, którego nie rozpoznajemy, daj nam znać, a dodamy je do bazy. Warianty regionalne (na przykład „Juan” wobec „John”) obsługujemy dzięki zbiorom danych osobnym dla każdego kraju.

Question 41

Czy API obsługuje imiona ze znakami specjalnymi i akcentami?

Accepted Answer

Tak! Nasze API w pełni obsługuje znaki Unicode, w tym litery z akcentami (é, ñ, ü), umlauty, znaki diakrytyczne oraz pisma inne niż łacińskie (arabskie, cyrylicę, chińskie itd.). W żądaniach do API imiona powinny być zakodowane w UTF-8. Na przykład „François”, „José”, „Müller” i „Søren” przetwarzamy poprawnie.
Kodowanie URL większość klientów HTTP obsługuje automatycznie, ale upewnij się, że znaki specjalne są zakodowane poprawnie.
Nasza baza danych zawiera imiona z 191 krajów i obejmuje wszystkie główne systemy pisma. Więcej szczegółów znajdziesz w naszej dokumentacji API.

Question 42

Jakich źródeł danych używacie?

Accepted Answer

Łączymy wiele autorytatywnych źródeł danych, aby zapewnić maksymalną dokładność. Należą do nich:  
dane spisów powszechnych i rejestry urodzeń z wielu krajów, publicznie dostępne bazy imion,  
media społecznościowe i sieci zawodowe (zanonimizowane i zgodne z RODO), historyczne rejestry imion  
oraz ręczne weryfikacje wykonywane przez nasz zespół danych. Wszystkie źródła są starannie sprawdzane  
i porównywane między sobą. Zawsze, gdy to możliwe, priorytetowo traktujemy oficjalne źródła rządowe.  
Nasze modele AI pomagają również identyfikować wzorce i sprawdzać spójność pomiędzy źródłami.  
Pełną listę obsługiwanych krajów znajdziesz tutaj.  
Naszą bazę danych regularnie aktualizujemy, gdy tylko pojawiają się nowe oficjalne dane.

Question 43

Jak zapewniacie prywatność i ochronę danych?

Accepted Answer

Bardzo poważnie podchodzimy do prywatności i przestrzegamy RODO, CCPA oraz innych międzynarodowych przepisów o ochronie danych. Imion, o które pytasz, nie przechowujemy dłużej, niż wymaga tego rejestrowanie zdarzeń niezbędne do działania usługi. Cała komunikacja z API jest szyfrowana przez HTTPS/TLS. Klientom korporacyjnym udostępniamy umowy powierzenia przetwarzania danych. Przesłane przez Ciebie pliki CSV/Excel usuwamy automatycznie po roku. Nigdy nie sprzedajemy ani nie udostępniamy danych klientów stronom trzecim. Nasze serwery stoją w bezpiecznych europejskich centrach danych. Wszystkie szczegóły znajdziesz w naszej pełnej polityce prywatności. Regularne audyty bezpieczeństwa pilnują stałej zgodności z przepisami.

Question 44

Czy mogę otrzymać faktury i potwierdzenia płatności za moje wpłaty?

Accepted Answer

Tak, faktury generujemy automatycznie dla wszystkich zakupów i znajdziesz je w panelu swojego konta. Faktury PDF możesz pobrać w każdej chwili; wysyłamy je też na zarejestrowany adres e-mail.
Faktury zawierają wszystkie dane potrzebne do księgowania, w tym informacje o VAT, jeśli ma zastosowanie.
Swoje dane rozliczeniowe i dane firmy możesz zaktualizować w dowolnym momencie, aby faktury zawierały poprawne informacje.
W sprawie starszych faktur lub niestandardowych wymagań napisz do wsparcia.

Question 45

Jaka jest wasza polityka zwrotów?

Accepted Answer

Przy pierwszym zakupie dajemy prostą, 14-dniową gwarancję zwrotu pieniędzy.
Jeśli w ciągu pierwszych 14 dni nasza usługa nie spełni Twoich oczekiwań, napisz do nas i zwrócimy całą kwotę – bez zbędnych pytań.
W przypadku płatności subskrypcyjnych możesz w każdej chwili anulować subskrypcję, aby zatrzymać kolejne obciążenia. Niewykorzystane kredyty z zakupów jednorazowych pozostają ważne przez rok. Zwracamy też środki z powodu problemów technicznych lub usterek usługi, rozpatrując każdą sytuację indywidualnie.
Szczegóły znajdziesz w naszych pełnych zasadach rezygnacji, a jeśli masz pytania – napisz do wsparcia.

Question 46

Jakie integracje zewnętrzne są dostępne?

Accepted Answer

Oferujemy integracje z popularnymi platformami i narzędziami, w tym z Zapier, Make (dawniej Integromat), Google Sheets, Microsoft Excel, Salesforce, HubSpot i wieloma systemami CRM. Nasze API działa z każdą platformą, która obsługuje API REST lub webhooki. Udostępniamy gotowe konektory oraz szczegółowe przewodniki integracyjne dla najpopularniejszych platform.
Możesz też skorzystać z naszej funkcji przesyłania plików CSV do jednorazowego przetworzenia danych, bez żadnej integracji.
W sprawie niestandardowych integracji lub obsługi konkretnej platformy zajrzyj do naszej dokumentacji albo napisz do wsparcia.

CZĘSTO ZADAWANE PYTANIA