Question 1

Co se stane, pokud má jméno mužskou i ženskou variantu?

Accepted Answer

V závislosti na verzi API nebo integraci, kterou používáte, naše endpointy vrátí v odpovědi buď přesnost, nebo hodnotu pravděpodobnosti. Parametr přesnosti udává, jak jsme si jisti, že je dané jméno mužské, nebo ženské. Hodnota se vypočítá z počtu záznamů v naší databázi. Například pokud máme 100 vzorků jména, 96 je ženských a 4 mužská, přesnost je 96 % (nebo pravděpodobnost 0,96). Nízká přesnost naznačuje, že toto jméno pravděpodobně používá více pohlaví a nelze je přiřadit ke konkrétnímu pohlaví.

Question 2

Mohou existovat rozdíly pro stejné jméno v závislosti na zemi?

Accepted Answer

Zatímco jméno Andrea je v Itálii mužské, v Německu je to ženské jméno a ve Spojených státech může být obojí. V takovém případě poskytujeme hodnotu přesnosti ve výsledku dotazu, která se pohybuje mezi 0 a 100 (nebo hodnotu pravděpodobnosti mezi 0 a 1). Říká vám, jak jsme si jisti, že jsme rozpoznali správné pohlaví. Kvalitu výsledků API můžete výrazně zvýšit tím, že k dotazu poskytnete některé zeměpisné informace. Může jít o kód země, jazykové nastavení prohlížeče nebo IP adresu. Více se o lokalizaci dotazu dozvíte v naší dokumentaci API.

Question 3

Jak shromažďujete data?

Accepted Answer

Abychom zajistili co nejvyšší přesnost, kombinujeme data z více zdrojů. Hlavními zdroji nových záznamů jsou veřejně dostupná data, vládní data a manuální dodatky/korekce. V závislosti na zdroji nového jména může být jméno před přidáním do našeho seznamu ověřeno druhým zdrojem. Například pokud přidáme jméno z veřejně dostupných dat, může toto jméno před konečným přidáním do naší databáze potřebovat druhé ověření, například ruční potvrzení. Seznam podporovaných zemí naleznete zde.

Question 4

Jak často aktualizujete jmenné záznamy?

Accepted Answer

Pravidelně aktualizujeme svá data v závislosti na zemi a dostupných veřejných datech.
 Většina západních zemí je aktualizována jednou ročně. Distribuce jmen podle pohlaví se také může v průběhu let měnit.
 Například jméno, které bylo používáno výhradně ženami v 70. letech, může být o desetiletí později převážně používáno muži.
 Proto také využíváme data o narozeních pro několik zemí, jako jsou USA, abychom obohatili výsledky. Naše modely se snaží vzít v úvahu všechny tyto faktory co nejlépe.
 Vracená hodnota přesnosti je pravidelně upravována, aby co nejlépe odrážela skutečné používání v populaci.
 Hodnota by měla poskytnout rozumné hodnocení na základě posledních desetiletí a může vyjadřovat možnou fluktuaci.
 Sledujeme asi poslední 4 desetiletí dat.
 Pokud provedete dotaz a zopakujete stejný dotaz o rok později, můžete získat jiný výsledek, protože náš systém
 může odstranit stará data a přidat nová data.
 Při každém přidání nových dat provádíme následně takzvané integrační testy.
 V tomto procesu je naše API testováno proti dříve ověřené datové sadě, aby byla zajištěna kvalita.
 Tato datová sada je neustále rozšiřována o jména a testovací případy, aby bylo dosaženo co nejširšího pokrytí.

Question 5

Jak využíváte AI?

Accepted Answer

Umělá inteligence (AI) je denně využívána ke zlepšování kvality naší databáze a výsledků API. Díky AI můžeme efektivně a přesně přidávat nové záznamy do naší databáze, čímž zajišťujeme, že naše informace jsou vždy aktuální.

Kromě toho hraje AI také klíčovou roli při zlepšování celkové kvality výsledků našeho API. Využitím algoritmů strojového učení můžeme efektivněji analyzovat data, identifikovat vzorce a poskytovat přesnější a relevantnější výsledky našim uživatelům.

Question 6

Poskytujete nějakou pomoc s implementací API?

Accepted Answer

Ano, poskytujeme e-mailovou podporu všem zákazníkům. Napsat nám můžete na contact gender-api.com. Jakmile to bude možné, ozveme se vám zpět. Příklady kódu najdete také zde. Upozorňujeme, že vám nemůžeme pomoci s každým programovacím jazykem a případem použití. Ve většině případů můžete pro dotazování na naše API ve své aplikaci použít standardního REST klienta. Mnoho knihoven podporuje také import souboru s definicí OpenAPI. Náš soubor s definicí openapi.yml si můžete stáhnout zde.

Question 7

Co když potřebujeme vysokou úroveň přesnosti?

Accepted Answer

Jazyky a jména jsou proměnlivé a v čase se mění. Od zákazníka k zákazníkovi se také datové sady značně liší v kvalitě, rozsahu i původu. Proto nemůžeme garantovat, že všechny výsledky, které od našeho API obdržíte, jsou 100% správné a odpovídají vašemu datovému fondu. Můžeme však slíbit, že jsme neustále odhodláni poskytovat vám co nejlepší výsledky a že pravidelně zlepšujeme a aktualizujeme naše algoritmy. Také velmi pravidelně přidáváme nová data. Více informací o našich aktualizacích naleznete zde. V nepravděpodobném případě, že naše služba nebude odpovídat vašim očekáváním, nabízíme vám jednoduchou 14denní záruku vrácení peněz. Samozřejmě také nabízíme možnost kompletně zdarma otestovat naši službu. Pokud se zaregistrujete zde, obdržíte 100 požadavků zdarma každý měsíc. Pokud dotazujete jméno, naše endpointy buď vrátí přesnost nebo pravděpodobnostní hodnotu v odpovědi, v závislosti na vaší verzi API. Parametr přesnosti vrátí, jak si jsme jisti, že je dané jméno mužské nebo ženské. Hodnota se vypočítá podle počtu záznamů pro toto jméno v naší databázi. Vzhledem k významným rozdílům v případech použití nedáváme žádná doporučení ohledně úrovně přesnosti. V závislosti na vašem případě použití je na vás, abyste se rozhodli, jaké výsledky a úrovně přesnosti akceptujete. I s přesností alespoň 99%, existuje možnost, že výsledek je nesprávný. Hodnota nad 95% však obecně vyhovuje většině případů použití

Question 8

Kolik jmen máte uloženo ve své databázi?

Accepted Answer

Naše databáze obsahuje 6,084,389 ověřených jmen z 191 různých zemí. Celosvětově ukládáme 6,450,268 unikátních jmen. V průměru měsíčně analyzujeme přibližně 10 000 000 datových sad, abychom zlepšili kvalitu našich výsledků.

Question 9

Které země jsou podporovány?

Accepted Answer

API plně podporuje 191 zemí. Plná podpora znamená, že jsme pro danou zemi shromáždili alespoň  jmen. Ve většině zemí je však náš dataset mnohem větší. Podrobnosti o tom, kolik jmen podporujeme ve které zemi, najdete v následující tabulce. Mějte na paměti, že pokud pro některou zemi sami nenabízíme vhodnou podporu, můžete požadovaná jména přesto porovnat s celým datasetem a získat tak odpovídající výsledek.

Question 10

Podporujete arabská jména?

Accepted Answer

Ano, naše API podporuje arabská jména. Lze je také psát znaky z arabské abecedy. Arabština se píše zprava doleva v kurzivním stylu a obsahuje 28 písmen. Jako příklad, pokud vyhledáte "عبد ال", dostanete následující výsledek: "gender": "male", "accuracy": 100. Arabské jméno "عبد ال" je v tomto příkladu zakódováno do URL a adresa URL by vypadala takto: https://gender-api.com/get?name=%D8%B9%D8%A8%D8%AF%20%D8%A7%D9%84&key=YOUR_API_KEY. Úplný seznam podporovaných zemí najdete zde

Question 11

Lze v jednom požadavku dotazovat více jmen?

Accepted Answer

Ano, to je zcela možné. Můžete dotazovat až 100 jmen najednou. Podrobnosti naleznete v naší dokumentaci API.

Question 12

Slyšel jsem o vašem e-mailovém API. Co přesně to je?

Accepted Answer

Naše e-mailové API dokáže extrahovat jména z e-mailových adres a přiřadit k dané adrese odpovídající pohlaví. To vám pomůže personalizovat e-maily správným oslovením. Například z e-mailové adresy „marie.johnson@gmail.com“ API extrahuje jméno „Marie“ a určí správné pohlaví, kterým je „žena“. Podrobnosti naleznete v naší dokumentaci API.

Question 13

Mám obrovské množství dat. Mohu hromadně nahrát soubor CSV?

Accepted Answer

Jako registrovaný uživatel můžete nahrát jakýkoli soubor CSV obsahující sloupec s křestním jménem.
 Pro lepší výsledek určení můžete do svého souboru volitelně přidat sloupec se zemí. I když není nutné konkrétně pojmenovávat sloupce, náš průvodce vás provede
 procesem tím, že vám umožní vybrat, který sloupec obsahuje který token, včetně křestního jména nebo země. Funkce se nachází ve vašem účtu. Zpracovaná data budou účtována jako požadavky, takže můžete nahrát
 soubor CSV s až 100 záznamy zdarma každý měsíc. Hromadné nahrávání CSV vyžaduje účet Gender-API.com. Z důvodu ochrany dat budou nahrané soubory automaticky smazány po jednom roce.

Question 14

Jaké formátování potřebuje soubor CSV?

Accepted Answer

Podporujeme soubory CSV vytvořené v systémech Windows, MacOS nebo Linux. Podporujeme také soubory s oddělovači jako „;“, „,“ nebo tabulátor. Uzavírací znak musí být ". Dále můžete nahrávat víceřádkové soubory CSV s maximálně 10 000 000 řádky a o velikosti do 301MB. Pro dosažení nejlepších výsledků doporučujeme použít soubor CSV ve formátu UTF-8 se středníkem jako oddělovačem. Soubor CSV může jinak obsahovat i další, libovolné řádky, které budou zahrnuty i do výstupního souboru. Soubor musí obsahovat alespoň jeden sloupec pouze s křestními jmény, nebo sloupec s celými jmény. Ukázkový soubor si stáhnete zde. Pro nahrání souboru CSV si prosím vytvořte účet na Gender-API.com.

Question 15

Mohu nahrát soubor Excel?

Accepted Answer

Můžete nahrát soubory Excel s až 300 000 řádky. Pro větší sady dat prosím použijte nahrávání souborů CSV.
Podporujeme soubory .xlsx s jedním listem. Pokud nahrajete soubor s více listy, bude zpracován pouze první.
První řádek ve vašem listu musí obsahovat názvy sloupců. Soubor musí obsahovat alespoň jeden sloupec s křestními jmény, sloupec se zemí je volitelný. Z důvodu ochrany dat budou nahrané soubory automaticky smazány po jednom roce. Stáhněte si ukázkový soubor zde. Příklad:

Question 16

Našel/a jsem chybu. Co mám dělat?

Accepted Answer

Velmi si vážíme vaší pomoci. Pošlete nám prosím e-mail na contact gender-api.com a my se budeme snažit tento problém co nejdříve opravit.

Question 17

Je Gender-API v souladu s Obecným nařízením o ochraně osobních údajů (GDPR)?

Accepted Answer

Všechny služby Gender-API.com jsou v plném souladu s GDPR. Poskytujeme smlouvu o zpracování osobních údajů (DPA), která vám umožňuje splnit vaše povinnosti vyplývající z GDPR. Tuto smlouvu si můžete vyžádat zde ve vašem účtu. Vzorovou smlouvu si můžete stáhnout zde. Více informací o tom, jak chráníme vaše data, naleznete zde.

Question 18

Poskytujete nějaké knihovny pro programovací jazyky?

Accepted Answer

Vzhledem k jednoduchosti našeho API neposkytujeme knihovnu pro žádný programovací jazyk, s výjimkou jQuery pluginu. Většina jazyků podporuje json parser přímo a pro téměř každý jiný jazyk již existuje externí knihovna, kterou můžete použít. Prohlédněte si naše příklady kódu pro zahájení používání API:

Question 19

Jak se počítají požadavky?

Accepted Answer

Každý účet bude automaticky dobíjen na 100 požadavků prvního dne každého měsíce, pokud zbývá méně než tento počet. 
Pouze v případě nalezení výsledku bude požadavek započítán. Jedno vyhledání jména se počítá jako jeden požadavek. 
Pokud je v jednom dotazu vyžádáno více jmen, každé jméno se počítá jako jeden požadavek.

Question 20

Kde najdu a spravuji své API klíče?

Accepted Answer

Při registraci účtu na Gender-API.com generujeme počáteční API klíč. Tento API klíč naleznete ve spodní části stránky s přehledem vašeho účtu. Pokud jej chcete zneplatnit, klikněte na tlačítko „Zrušit a vygenerovat znovu“. Náš systém pak stávající API klíč zneplatní a vygeneruje nový. Všechny vaše aplikace, které používají starý token, pak nebudou moci přistupovat k našemu API, dokud tento kód nenahradíte novým API klíčem. [apiKeyImage] Můžete si také vytvořit více než jeden API klíč. To se hodí například v případě, že máte několik aplikací, do kterých chcete naše API zahrnout. Upozorňujeme, že se nerozlišuje, který klíč kolik požadavků spotřeboval. Všechny požadavky se počítají společně. Pro správu nebo vytvoření více API klíčů klikněte na tlačítko „Nastavení“ v nabídce účtu a poté na „API klíče“. [multipleKeysImage] Kliknutím na tlačítko „Vytvořit nový klíč“ můžete vygenerovat nový API klíč. Každému tokenu můžete dát jméno, abyste později snadněji poznali, kde se tento klíč používá. Toto jméno můžete kdykoli změnit. Některé z našich widgetů zde klíč vygenerují automaticky. Například pokud ve svém účtu používáte náš „Rychlý vyhledávací widget“, náš systém klíč vygeneruje předem a widget pak tento token použije k dotazování našeho API. Kromě toho si zde po připojení vytvoří klíč i aplikace třetích stran. Každý token lze kdykoli zneplatnit jednoduchým kliknutím na „x“. Jakmile je klíč zneplatněn, připojená aplikace už nebude mít přístup k našemu API.

Question 21

Mohu sdílet svůj účet s více lidmi?

Accepted Answer

Můžete sdílet svůj účet s až 50 kolegy nebo dalšími lidmi spojenými s vaším projektem. Pro správu týmu se přihlaste do svého účtu a v nabídce účtu klikněte na "Nastavení" => "Správa týmu". Na této stránce klikněte na tlačítko "Pozvat nového člena" a pozvěte lidi e-mailem do svého týmu. Při zvání členů si můžete vybrat ze dvou různých typů účtů. 
A) Uživatelé mohou prohlížet, vytvářet, aktualizovat a mazat API klíče, nahrávat soubory CSV a Excel a určovat v nich pohlaví, přistupovat ke všem API endpointům, nakupovat požadavky a připojovat aplikace třetích stran. B) Administrátoři mohou dělat to samé, co uživatelé, a navíc aktualizovat nastavení účtu a fakturační adresu, vytvářet a prohlížet smlouvy o zpracování osobních údajů, zvát, upravovat a mazat členy týmu.

Question 22

Mohu ochránit svůj účet povolením dvoufázového ověření?

Accepted Answer

Můžete si zabezpečit svůj účet povolením dvoufázového ověření. Chcete-li tuto dodatečnou bezpečnostní funkci povolit, přihlaste se ke svému účtu a v nabídce Účty klikněte na "Nastavení" => "Změnit heslo / 2FA". Ujistěte se, že máte v telefonu nainstalovanou aplikaci pro ověřování. Doporučujeme použít aplikaci jako Authy (App Store, Play Store) nebo Google Authenticator (App Store, Play Store). 
 Poté klikněte na tlačítko "Povolit nyní" a postupujte podle pokynů na obrazovce. Můžete zde přidat více zařízení, abyste zajistili například přístup ke svému účtu i po ztrátě zařízení.
 Jakmile je povoleno, budete muset zadat vygenerovaný kód z ověřovací aplikace v telefonu pro úspěšné přihlášení.

Question 23

Mohu používat aplikace třetích stran, když je dvoufázové ověření povoleno?

Accepted Answer

Některé integrace nebo aplikace třetích stran fungují bezchybně i s povoleným dvoufázovým ověřením. Jiné mohou vyžadovat připojení bez dvoufázového ověření.
 Pokud máte problémy s přihlášením do některé aplikace pomocí svých údajů Gender-API.com, přihlaste se ke svému účtu přímo na Gender-API a klikněte v nabídce účtu na "Nastavení" => "Změnit heslo / 2FA". Poté klikněte na záložku "Dvoufázové ověření" a nastavte "Přístup pro aplikace třetích stran" na "Není omezeno".
 Upozorňujeme, že toto nastavení můžete změnit pouze v případě, že je dvoufázové ověření povoleno.

Question 24

Co jsou přístupové klíče (passkeys) a jak fungují?

Accepted Answer

Přístupové klíče (passkeys) jsou moderní způsob přihlašování bez hesla, který nabízí výrazně vyšší zabezpečení než tradiční hesla.
Místo zadávání hesla se přihlásíte pomocí vestavěných bezpečnostních funkcí svého zařízení, jako je Face ID, Touch ID, Windows Hello nebo PIN.
Passkeys vycházejí ze standardu WebAuthn a jsou odolné vůči phishingu, protože jsou kryptograficky svázané s konkrétními weby.
Váš soukromý klíč nikdy neopustí vaše zařízení, takže jsou passkeys bezpečnější než hesla. Jakmile si pro svůj účet Gender-API.com nastavíte passkey,
přihlásíte se pouhým dotykem nebo pohledem – bez hesla. Passkeys fungují napříč zařízeními a můžou se synchronizovat přes iCloud Klíčenku, Správce hesel Google nebo podobné služby.

Question 25

Jak si pro svůj účet nastavím přístupový klíč (passkey)?

Accepted Answer

Nastavení přístupového klíče proběhne automaticky během přihlášení. Když se přihlásíte e-mailem a heslem, systém vás vyzve k vytvoření přístupového klíče pro rychlejší přihlašování v budoucnu. Stačí postupovat podle pokynů na svém zařízení – prohlížeč vás požádá o ověření identity pomocí Face ID, Touch ID, Windows Hello nebo PINu zařízení. Po ověření se přístupový klíč automaticky uloží do vašeho zařízení a je připravený k použití. Až příště navštívíte Gender-API.com, přihlásíte se okamžitě jen pomocí přístupového klíče, bez psaní hesla.

Pokud chcete dál používat heslo, nastavení přístupového klíče můžete přeskočit.

Poznámka: Přístupové klíče vyžadují kompatibilní prohlížeč (Chrome, Safari, Edge, Firefox) a operační systém.

Question 26

Jak se přístupové klíče liší od dvoufázového ověření (2FA)?

Accepted Answer

Obě možnosti zvyšují bezpečnost, ale fungují jinak. Dvoufázové ověření (2FA) přidá po zadání hesla ještě druhý krok – obvykle kód z aplikace pro ověřování. Přístupové klíče naopak heslo úplně nahrazují a zajistí vícefaktorové zabezpečení v jediném kroku tím, že kombinují něco, co máte (vaše zařízení), s něčím, čím jste (biometrie), nebo co znáte (PIN zařízení).

Přístupové klíče jsou považované za bezpečnější, protože jsou odolné vůči phishingu (fungují jen na správném, autentickém webu), nejsou ohrožené únikem databáze hesel a nedají se uhodnout ani prolomit.

Pokud máte zapnuté přístupové klíče i 2FA, přihlášení přístupovým klíčem přeskočí výzvu k 2FA, protože přístupové klíče už samy o sobě poskytují stejnou nebo ještě vyšší úroveň zabezpečení.

Question 27

Co se stane, když ztratím zařízení se svým přístupovým klíčem?

Accepted Answer

Když ztratíte zařízení s přístupovým klíčem, nemusíte se bát – váš účet je stále bezpečný a dostupný.
Vždy se můžete přihlásit pomocí hesla (a 2FA, pokud je zapnuté). Pokud máte přístupové klíče synchronizované přes iCloud Keychain nebo Google Password Manager, automaticky budou k dispozici i na dalších zařízeních, kde jste přihlášeni ke stejnému účtu.
Pro maximální bezpečnost doporučujeme: nastavit přístupové klíče na více zařízeních, ponechat si heslo jako zálohu a zapnout 2FA jako další vrstvu ochrany. Přístupové klíče si také můžete spravovat v nastavení účtu – odeberete tak přístupový klíč ztraceného zařízení a zabráníte případnému neoprávněnému přístupu.

Question 28

Jaký je rozdíl mezi placeným a bezplatným účtem?

Accepted Answer

Oba typy účtů nabízejí stejnou funkcionalitu. Všechny endpointy API jsou dostupné pro oba typy účtů a vrátí stejné výsledky. Bezplatné účty jsou omezeny na určitý počet požadavků za měsíc. Při registraci jsou vám okamžitě k dispozici 100 požadavků zdarma. Prvního dne každého měsíce náš systém tento počet resetuje, a bezplatné požadavky budou dostupné znovu. Vytvořte prosím pouze jeden účet. Pokud potřebujete více požadavků, můžete kdykoli upgradovat na jeden z našich placených plánů zde.

Question 29

Jak se můžu odhlásit ze všech zařízení?

Accepted Answer

Pokud kliknete na tlačítko odhlášení ve svém účtu, budete odhlášeni pouze z aktuálního zařízení.
 Pro zajištění bezpečnosti vašeho účtu a dat je důležité se v případě potřeby odhlásit ze všech zařízení. Pro úspěšné odhlášení ze všech zařízení na naší API platformě postupujte podle níže uvedených pokynů.
 Po přihlášení klikněte zde pro odhlášení ze všech zařízení. Pokud změníte své heslo nebo upravíte nastavení dvoufázového ověření, systém vás také automaticky odhlásí ze všech zařízení, která neodpovídají vaší aktuální IP adrese. To přidává další vrstvu zabezpečení vašeho účtu. Pro zvýšení bezpečnosti a snazší spolupráci v týmu doporučujeme vytvořit samostatné účty pro každého člena týmu.
 Dále pro zvýšení bezpečnosti vašeho účtu důrazně doporučujeme zapnout dvoufázové ověření (2FA). Tato další vrstva ochrany přidává do procesu přihlášení jeden krok navíc,
 což neoprávněným osobám ztěžuje získání přístupu.

Question 30

Jaký je rozdíl mezi předplatným a jednorázovou platbou?

Accepted Answer

Pokud si chcete koupit jeden z našich balíčků, můžete zvolit mezi jednorázovou platbou, nebo předplatným tohoto balíčku. Předplatné doporučujeme, pokud chcete naši službu používat pravidelně. Můžete se spolehnout, že ve vašem účtu bude vždy dost zbývajících požadavků. Požadavky zakoupené s předplatným lze využít během jednoho měsíce. S aktivním předplatným náš systém po jednom měsíci doplní váš účet na zvolený počet požadavků. Pokud máte například předplacený balíček s 25 000 požadavky a spotřebovali jste jich 21 500, náš systém po jednom měsíci doplní váš účet zpět na 25 000 požadavků. Jednorázové balíčky lze koupit pro jednorázové využití a lze je použít do jednoho roku. Pokud chcete například zpracovat soubor Excel nebo CSV, doporučujeme jednorázový nákup. Jednorázové nákupy se automaticky neobnovují, proto si musíte hlídat, abyste nevyčerpali všechny požadavky. Mezi oběma typy balíčků můžete přepínat na naší nákupní stránce.

[difference]
Prosím nemíchejte oba typy nákupů, dokud si nepromluvíte s naší podporou nebo přesně nevíte, co děláte. Zakoupení jednorázového balíčku v době, kdy máte předplatné jednoho z našich balíčků, může zabránit doplnění požadavků předplatným. Například pokud je z jednorázového nákupu zbývajících požadavků více než by předplatné doplnilo.

Question 31

Potřebuji potvrzení o daňovém domicilu. Můžete takové potvrzení vystavit?

Accepted Answer

Pokud od naší firmy potřebujete potvrzení o daňovém domicilu, kontaktujte prosím naši podporu se svým požadavkem. Potvrzení je nutné vyžádat individuálně pro každou společnost. Do požadavku uveďte plnou adresu vaší společnosti, zemi vašeho sídla a, pokud je k dispozici, daňové identifikační číslo. Potvrzení o daňovém domicilu musí podepsat náš finanční úřad. Obvykle trvá 2–3 týdny, než podepsaný formulář obdržíme, a pak vám ho můžeme poskytnout jako digitální sken.

[certificate-of-residence]

Question 32

Jak mohu koupit balíček / více požadavků?

Accepted Answer

Můžete si vybrat mezi předplatným, nebo jednorázovou platbou zde. Jednorázová platba se doporučuje, pokud chcete zpracovat velký soubor CSV nebo pokud dáváte přednost používání požadavků nepravidelně. Svůj účet můžete kdykoli dobít požadovaným množstvím požadavků. Požadavky zakoupené jednorázovou platbou lze využít do jednoho roku. Pokud dáváte přednost předplatnému, bude váš účet každý měsíc doplněn na zvolené množství požadavků. Předplatné lze kdykoli změnit nebo zrušit.

Question 33

Jak mohu zrušit své předplatné?

Accepted Answer

Své předplatné můžete kdykoli změnit nebo zrušit zde. Pokud chcete zastavit opakované platby, klikněte na tlačítko „Zrušit toto předplatné“.

Question 34

Jaká je typická doba odezvy API?

Accepted Answer

Naše API je navrženo pro vysoký výkon a obvykle odpovídá během 10–200 milisekund.
 Doba odezvy se může mírně lišit podle vašeho geografického umístění, podmínek v síti a složitosti vašeho dotazu.
 U dávkových požadavků s více jmény se doba odezvy škáluje lineárně. Používáme globální CDN a optimalizovanou infrastrukturu,
 abychom zajistili nízkou latenci po celém světě. Pokud jsou doby odezvy trvale pomalé, kontaktujte prosím náš tým podpory.

Question 35

Existují nějaké limity rychlosti nebo omezení požadavků?

Accepted Answer

Implementujeme limity spravedlivého používání, abychom zajistili optimální službu pro všechny uživatele.
Bezplatné účty mohou provést až 100 požadavků za měsíc. Placené účty mají vyšší limity:
1500 požadavků za minutu a žádná denní omezení, pokud máte dostupné kredity.
Pokud potřebujete vyšší limity pro svůj konkrétní případ použití, kontaktujte nás a proberte individuální plán.
Dávkové požadavky (až 100 jmen na požadavek) se počítají jako jednotlivé požadavky, ale jsou efektivnější.

Question 36

Jaká je garance dostupnosti vašeho API?

Accepted Answer

Garantujeme dostupnost API 99,9 % u všech placených tarifů. Naše infrastruktura běží na serverech podnikové třídy s automatickým přepínáním a vyvažováním zátěže. Systémy monitorujeme nepřetržitě 24/7 a máme automatická upozornění na jakékoli problémy.
 Firemním zákazníkům poskytujeme také smlouvu o úrovni služeb (SLA). Ve vzácném případě delšího výpadku obdrží platící zákazníci automaticky kredity za službu podle podmínek naší SLA.

Question 37

V jakém formátu API odpovídá?

Accepted Answer

Naše API vrací odpovědi ve výchozím nastavení ve formátu JSON, který je široce podporován všemi moderními
 programovacími jazyky. Každá odpověď obsahuje dotazované jméno, určené pohlaví, hodnotu přesnosti/pravděpodobnosti a další metadata. Například: {"name":"Maria","gender":"female","accuracy":99,"samples":12847,"country":"US"}.
 Podrobná schémata odpovědí najdete v naší dokumentaci API
 a pro automatické generování klienta si můžete stáhnout naši specifikaci OpenAPI.

Question 38

Jak bych měl/a řešit chyby API?

Accepted Answer

Naše API používá standardní stavové kódy HTTP k indikaci úspěchu nebo neúspěchu.
 200 znamená úspěch, 401 znamená neplatný API klíč, 429 překročený limit požadavků a 500 chybu serveru.
 Každá chybová odpověď obsahuje popisnou zprávu a kód chyby pro snadnější ladění.
 Doporučujeme u chyb limitu požadavků implementovat exponenciální odstup (backoff) a úspěšné odpovědi podle možností ukládat do mezipaměti.
 U trvalých chyb nahlédněte do naší dokumentace API nebo kontaktujte podporu.
 Všechny chyby zaznamenáváme pro účely řešení problémů.

Question 39

Jak provádíte verzování API?

Accepted Answer

Aktuálně udržujeme dvě verze API: V1 a V2. V2 je naše nejnovější verze s vylepšenými funkcemi včetně hodnot pravděpodobnosti, rozšířené podpory zemí a zvýšené přesnosti. V1 zůstává dostupná pro zpětnou kompatibilitu, ale doporučujeme migraci na V2 pro nové integrace. Všechny endpointy API obsahují verzi v cestě URL (např. /v2/name). Garantujeme, že starší verze API budou i nadále fungovat. Návody pro migraci jsou k dispozici v naší dokumentaci API. Zásadní změny jsou vždy dobře předem komunikovány.

Question 40

Jak řešíte varianty jmen a přezdívky?

Accepted Answer

Naše databáze zahrnuje běžné varianty jmen, zdrobněliny a přezdívky. Například "Bob" je rozpoznán jako varianta jména "Robert" a "Liz" jako varianta jména "Elizabeth". Pro nejlepší přesnost však doporučujeme dotazovat se na celé křestní jméno, pokud je k dispozici. Naše AI systémy se z našich dat průběžně učí nové varianty jmen. Pokud narazíte na přezdívku, která není rozpoznána, dejte nám prosím vědět a my ji do databáze přidáme. Regionální varianty (jako "Juan" vs "John") řešíme pomocí datových sad pro jednotlivé země.

Question 41

Podporuje API jména se speciálními znaky a diakritikou?

Accepted Answer

Ano! Naše API plně podporuje znaky Unicode včetně písmen s diakritikou (é, ñ, ü), přehlasovaných samohlásek, diakritických znamének a nelatinských písem (arabské, cyrilice, čínské atd.). Jména by měla být ve vašich požadavcích na API kódována v UTF-8. Například „François“, „José“, „Müller“ a „Søren“ se zpracují správně. Kódování URL obsluhuje většina HTTP klientů automaticky, ale zajistěte správné kódování speciálních znaků. Naše databáze obsahuje jména z 191 zemí pokrývajících všechny hlavní systémy písma. Další podrobnosti najdete v naší dokumentaci API.

Question 42

Jaké zdroje dat používáte?

Accepted Answer

Kombinujeme více autoritativních zdrojů dat, abychom zajistili maximální přesnost. Patří mezi ně:
 údaje z vládních sčítání lidu a rodných listů z mnoha zemí, veřejně dostupné databáze jmen,
 sociální sítě a profesní sítě (anonymizované a v souladu s GDPR), historické záznamy jmen
 a ruční ověřování naším datovým týmem. Všechny zdroje dat pečlivě prověřujeme a křížově ověřujeme.
 Tam, kde jsou k dispozici, dáváme přednost oficiálním vládním zdrojům. Naše modely umělé inteligence také pomáhají identifikovat vzorce a
 ověřovat konzistenci mezi zdroji. Úplný seznam podporovaných zemí je k dispozici zde.
 Databázi pravidelně aktualizujeme, jakmile jsou k dispozici nová oficiální data.

Question 43

Jak zajišťujete ochranu soukromí a dat?

Accepted Answer

Bereme soukromí velmi vážně a dodržujeme GDPR, CCPA i další mezinárodní předpisy o ochraně osobních údajů. Jména, na která se dotazujete, neukládáme nad rámec protokolování nezbytného pro provoz služby. Veškerá komunikace přes API je šifrovaná pomocí HTTPS/TLS. Firemním zákazníkům nabízíme smlouvy o zpracování osobních údajů. Nahrané soubory CSV/Excel se automaticky mažou po jednom roce. Zákaznická data nikdy neprodáváme ani nesdílíme s třetími stranami. Naše servery se nacházejí v bezpečných evropských datových centrech. Všechny podrobnosti najdete v našich úplných zásadách ochrany osobních údajů. Průběžný soulad zajišťují pravidelné bezpečnostní audity.

Question 44

Je možné získat faktury a potvrzení o platbách?

Accepted Answer

Ano, faktury se generují automaticky u všech nákupů a jsou dostupné ve vašem
 přehledu účtu. Faktury si můžete kdykoli stáhnout ve formátu PDF a posíláme je také na vaši registrovanou e-mailovou adresu.
 Faktury obsahují všechny údaje potřebné pro účetnictví včetně informací o DPH tam, kde je to relevantní.
 Své fakturační údaje a firemní data můžete kdykoli aktualizovat, aby faktury obsahovaly správné informace.
 V případě starších faktur nebo specifických požadavků na fakturaci nás prosím kontaktujte.

Question 45

Jaké jsou vaše zásady vracení peněz?

Accepted Answer

Nabízíme jednoduchou 14denní záruku vrácení peněz pro první nákupy. 
 Pokud naše služba nesplňuje vaše očekávání do 14 dnů, kontaktujte nás pro vrácení peněz – bez otázek. 
 U předplatných můžete zrušit kdykoli, abyste zastavili budoucí platby. Nevyužité kredity z jednorázových nákupů 
 zůstávají platné po dobu jednoho roku. Poskytujeme také vrácení peněz za technické problémy nebo problémy se službou v závislosti na konkrétním případu. 
 Přečtěte si naše úplné zásady zrušení nebo kontaktujte podporu s jakýmikoli otázkami.

Question 46

Jaké integrace třetích stran jsou k dispozici?

Accepted Answer

Nabízíme integrace s populárními platformami a nástroji včetně Zapieru, Make (dříve Integromat),
 Google Sheets, Microsoft Excel, Salesforce, HubSpotu a mnoha CRM systémů. Naše API funguje s jakoukoli platformou, která podporuje
 REST API nebo webhooky. Poskytujeme hotové konektory a podrobné návody na integraci pro hlavní platformy.
 Pro jednorázové zpracování dat bez jakékoli integrace můžete použít i naši funkci nahrávání CSV.
 V případě vlastních integrací nebo podpory konkrétní platformy nahlédněte do naší dokumentace nebo kontaktujte podporu.

ČASTO KLADENÉ OTÁZKY