S hrdostí ti představujeme náš nový API endpoint V2.0 s mnohem modernějším rozhraním

person Markus Perl
genderapi
Genderizuj jména REST JSON

Pokud jsi pokročilý uživatel a posíláš velké množství požadavků, můžeš přejít na náš nový endpoint API V2.0. Sjednocené API je výrazně rychlejší a nabízí robustnější rozhraní při dotazování na více jmen v jednom požadavku.

V jednom požadavku můžeš ověřit až 100 jmen

V jednom požadavku můžeš zadat až 100 jmen a klidně můžeš kombinovat vstupní data. Například jedno jméno můžeš odeslat s kódem země, zatímco jiné jméno odešleš bez kódu země – vše v jednom dotazu.

Až 200× rychlejší

Tenhle nový endpoint jsme vyvinuli společně s několika našimi největšími zákazníky, aby splňoval jejich požadavky na rychlost, stabilitu a škálování. Oproti požadavkům, které ověřují jen jedno jméno, je tenhle API endpoint až 200× rychlejší.

Bezpečnější

Teď si můžeš pro všechny své projekty generovat jedinečné ověřovací tokeny. Tyto tokeny můžeš v případě potřeby kdykoli zneplatnit. Své ověřovací tokeny můžeš spravovat tady.

Vyzkoušej si to nanečisto

Abys viděl(a), jak snadné je komunikovat s tímhle JSON API endpointem, najdeš ukázkový příklad na codepen.io.

Codepen.io se připojí k tvému účtu na Gender-API.com a ukáže ti jednoduchý příklad, jak vypadají vstupní data a jaká bude odpověď.

Otestuj to živě na codepen.io

Dotaz na jedno jméno

{"first_name":"Sandra"}

Dotaz na více jmen najednou

[{"first_name":"Sandra"}, {"first_name":"Mike", "country":"US"}]

Nebylo to snadné? Stačilo, že jsme kolem dvou objektů se jmény přidali hranaté závorky, a tím jsme naší API řekli: „prosím, vrať výsledek také jako pole“. V jednom volání REST API můžeš najednou dotazovat až na 100 jmen.

Můžeš kombinovat dotazy na gender jak pro e‑mailové adresy, tak pro jména. Určení genderu podle e‑mailové adresy je stejně jednoduché jako určení podle křestního jména. Do JSON požadavku jen místo pole first_name přidej pole email. Technologie, která stojí za určením genderu e‑mailové adresy, je ale mnohem složitější. Spolupracuje několik různých algoritmů zpracování, aby ti poskytly co nejpřesnější možné výsledky.

{"email":"theresa.miller14@gmail.com"}

Je stávající API V1.0 teď už zastaralé?

Ne, V1.0 nabízí rozhraní, které se velmi snadno integruje, zatímco V2.0 se lépe hodí pro zákazníky, kteří mají vysoký objem požadavků. Obě budou vyvíjeny a spravovány stejně.

Zobrazit dokumentaci API

Doufáme, že jsme ti dokázali poskytnout krátký přehled a rychlý úvod do našeho nového Genderize API. V sekci naše API dokumentace najdeš všechny technické informace, pokročilé funkce i příklady. Pokud máš nějaké otázky, klidně kontaktuj náš tým.

Chat