Propojení Make s GenderAPI.io V2

Zvolte připojení ve službě Make, které odpovídá vaší specifikaci API

Nastavení HTTP v tomto průvodci volá GenderAPI.io V2 na adrese https://api.genderapi.io/api/v2/gender. V těle JSON pošlete type a value. Odhad najdete v data, údaje o požadavku a účtování v meta. Vestavěné konektory mají vlastní specifikace, které jsou popsané níže.

Make nabízí aplikaci GenderAPI.io s akcemi pro jména a e-mailové adresy. Veřejná stránka aplikace odkazuje na genderapi.io, ale neuvádí úplnou verzi endpointu ani schéma odpovědi. Než namapujete pole ve stávajících scénářích, zkontrolujte skutečný výstup zvoleného modulu.

Pro výslovné chování V2 použijte aplikaci HTTP ve službě Make s požadavkem níže. Nastavení HTTP stávající modul GenderAPI na novou verzi nepřevede. Funkční scénáře ponechte oddělené, dokud náhradu neověříte.

Připravte účet a zdrojový záznam

Tento příklad obohacuje záznamy v aplikaci Shopify podle e-mailové adresy. Potřebujete přístup ke zdrojové i cílové aplikaci, API klíč účtu GenderAPI.io a funkce platformy, které akce HTTP používá. Průvodce neobsahuje funkční přihlašovací údaje ani propojené účty.

V1 a V2 používají stejný API klíč účtu a stejný zůstatek. Než nastavíte požadavek, který se účtuje, ověřte klíč pomocí GET /api/v2/usage a zkontrolujte, že pole meta.access.mode má v odpovědi tohoto endpointu hodnotu api_key. Chybějící nebo nerozpoznaný klíč může přejít na sdílený zkušební režim podle IP. Automatizace v produkčním prostředí by na něm neměla běžet, aniž byste o tom věděli.

Během konfigurace nechte workflow vypnuté. Testovací odhad spotřebuje běžné kredity. Tento návod byl zkontrolován podle veřejné dokumentace a specifikace V2. Pro tuto publikaci nebylo na žádné platformě spuštěno autentizované workflow od začátku do konce.

Autentizace a bezplatná kontrola využití

Nastavte požadavek GenderAPI.io V2 ve službě Make

Vyberte spouštěč Shopify pro zákazníky, který odpovídá vašemu scénáři, a načtěte reprezentativní testovací záznam. ID zákazníka si ponechte pro závěrečnou aktualizaci a záznamy s prázdným e-mailem přeskočte.
Přidejte HTTP > Make a request. V aktuální aplikaci HTTP zvolte autentizaci pomocí API klíče a vytvořte přihlašovací údaje s hodnotou klíče Bearer YOUR_API_KEY, umístěním Header a názvem parametru Authorization. Klíč nevkládejte do URL, ale použijte úložiště přihlašovacích údajů.
Nastavte metodu POST a URL uvedenou níže. Pro tělo požadavku zvolte application/json a datovou strukturu s textovými poli type a value a kolekcí options s textovým polem ai_mode. Nastavte type na email a ai_mode na off a do pole value namapujte e-mail zákazníka.
Zapněte Parse response. Tělo sestavené pomocí datové struktury ve službě Make serializuje namapované hodnoty jako JSON, takže jména nebo adresy s uvozovkami nevyžadují ruční skládání textu.

Nastavení HTTP	Hodnota	Účel
`Method`	`POST`	Odešle jeden požadavek na odhad.
`URL`	`https://api.genderapi.io/api/v2/gender`	Endpoint GenderAPI.io V2 pro jednotlivé odhady.
`Authorization`	`Bearer YOUR_API_KEY`	Zástupnou hodnotu nahraďte v nastavení ověřování nebo hlaviček platformy.
`Content-Type`	`application/json`	Odešle objekt s vnořeným objektem options, nikoli pole formuláře.
`options.ai_mode`	`off`	Záměrný první test pouze s datovou sadou. Běžně se účtuje 1 kredit, i když je výsledek neznámý.

Před odesláním zkontrolujte tělo JSON

Příklad ukazuje pevně daný vstup, nikoli očekávaný výsledek. Nejprve ověřte strukturu požadavku a potom nahraďte hodnotu pole value namapovaným zdrojovým polem se správnou serializací do JSON. Výrazy pro mapování z platformy nevkládejte do API jako doslovný text.

Pro jiný vstup nastavte type na name, email nebo username a do pole value zadejte odpovídající hodnotu. Pole country přidejte jen tehdy, když máte spolehlivý kontext. Je nepovinné a neslouží ke zjištění země, ve které osoba žije.

{
  "type": "email",
  "value": "alex@example.com",
  "options": {
    "ai_mode": "off"
  }
}

Všechna pole, typy a výchozí hodnoty požadavku

Před zapnutím aktualizací zkontrolujte krok HTTP

U tohoto pevného cíle API přes HTTPS nechte přesměrování vypnuté. Pokud přecházíte mezi verzemi aplikace HTTP ve službě Make, znovu zkontrolujte nastavení autentizace a těla požadavku, protože ovládací prvky se mohou lišit.

Spusťte jeden záměrný test, zkontrolujte balíček (bundle) se zpracovanou odpovědí a ještě před přidáním aktualizace zákazníka vytvořte samostatné trasy pro přijaté výsledky identified, výsledky unknown a provozní chyby.

Výsledky identified, unknown a chyby zpracujte odděleně

Než zvolíte aktualizaci v cílové aplikaci, zpracujte tělo odpovědi. Cesty JSON níže odkazují na tělo odpovědi V2. Vaše platforma ho může zabalit nebo zploštit. Skutečně vrácenou strukturu potvrďte záměrným testem a výsledek udržujte propojený s ID zdrojového záznamu.

Odhad neurčuje identitu osoby ani pohlaví, které osoba sama uvedla. Ukládejte ho odděleně od údajů, které osoba sama poskytla. Kritéria přijetí volte podle dat, která jsou reprezentativní pro váš vlastní případ použití, a spolehlivost z datové sady a spolehlivost z AI posuzujte odděleně.

Kontrola	Očekávaná hodnota nebo typ	Rozhodnutí ve workflow
`meta.access.mode`	api_key pro toto workflow s účtem	Pokud je hodnota ip_trial, workflow zastavte a opravte klíč. Úspěšná odpověď ze zkušebního režimu podle IP nedokazuje, že byl účet autentizován, a mohla už spotřebovat kredity ze zkušebního režimu.
`meta.usage.billing_status`	confirmed nebo unconfirmed	Pokud je hodnota unconfirmed, uchovejte ID požadavku a před opakovaným pokusem nebo pokračováním nechte účtování ověřit.
`data.result_status / data.gender`	identified s male nebo female; unknown s null	Přijaté výsledky identified směrujte do samostatného pole pro odvozené údaje. Výsledky unknown zachovejte bez přiřazení výchozí kategorie.
`data.confidence / data.confidence_kind`	číslo od 0 do 1 nebo null; druh podkladu nebo null	Hodnoty observed_frequency a model_reported vykládejte odděleně. Žádná z nich není obecnou zárukou přesnosti.
`data.source / data.sample_count`	dataset, ai nebo none / celé číslo nebo null	Uchovejte informaci o tom, jak byl odhad získán. AI nemá žádný uložený počet vzorků a počet z datové sady není měřítkem přesnosti produktu.
`meta.request_id / meta.usage`	identifikátor požadavku / objekt využití	Obojí ukládejte spolu se záznamem a výsledkem ve workflow. API klíče a zbytečné osobní údaje nezapisujte do běžných logů.
`Chyba HTTP / chybějící odpověď`	Problem Details nebo žádná úplná odpověď	Aktualizaci pozastavte a zkontrolujte chybu a stav účtování. Vypršení časového limitu nedokazuje, že server neprovedl žádnou práci.

Aktualizujte jen odpovídající záznam v aplikaci Shopify

Ve zpracované odpovědi HTTP namapujte níže uvedené cesty těla odpovědi V2. Make může tělo umístit pod výstupní označení modulu: vnořené objekty data a meta vyberte z balíčku, který jste zkontrolovali. Aktualizujte pouze zákazníka s ID, které uložil spouštěč, a to v samostatném poli pro odvozené údaje nebo podle stanovených pravidel pro štítky.

Před zapnutím aktualizací otestujte větve pro výsledek identified, neznámý výsledek a chybu. Pomocí smyšlených ukázkových odpovědí ověříte podmínky větví, aniž byste odesílali nový požadavek na odhad. Aktualizace v cílové aplikaci má záviset na výše uvedených kontrolách a nesmí přepsat pole ani štítky, kterých se netýká.

Hlídejte opakované pokusy a opakované účtování

Zkontrolujte obslužné rutiny chyb ve službě Make a nastavení nedokončených spuštění. Některé dočasné chyby se mohou opakovat i bez výslovné obslužné rutiny Retry. Opakovaný pokus v modulu HTTP může odeslat nový požadavek, který se účtuje. Pokud požadavek uspěl, ale pozdější aktualizace v aplikaci Shopify selhala, použijte při opravě této aktualizace uložený výstup požadavku.

Každý nový požadavek na GenderAPI je samostatná operace. Duplicitní zdrojové události odstraňte ve svém workflow ještě před odesláním pomocí uloženého ID zdrojového záznamu a stavu zpracování. ID zdrojového záznamu není klíč, který by opakování blokoval na straně serveru.

Úspěšný neznámý výsledek je dokončený výsledek, který se účtuje. Při vypršení časového limitu nebo neúplné odpovědi může být neznámý výsledek i účtování. Pokud je k dispozici identifikátor požadavku, uchovejte ho a před opětovným odesláním nechte účtování ověřit. Pokud odpověď při překročení limitu obsahuje hlavičku Retry-After, řiďte se jí.

Kredity a stav účtování

Rozhodněte, kdy použít AI

forceToGenderize je volitelné pro jména, e-mailové adresy i uživatelská jména. Pokud je zapnuté, ai_mode vynechte nebo použijte fallback; off a always jsou s ním v konfliktu a vrátí 422. K zahájení požadavku stačí kladný počáteční zůstatek, i když konečné vyúčtování dostane zůstatek do záporu.

Režim přezdívek může vrátit pohlaví spolu s name: null. Může také vrátit neznámý výsledek. Běžná záložní AI ani analýza přezdívek nezaručuje správnou odpověď ani hodnotu jinou než null.

Možnost požadavku	Chování	Kredity za úspěšné vyhledání
options.ai_mode: off	Použije pouze datovou sadu.	1, včetně neznámého výsledku
options.ai_mode: fallback	Nejprve prohledá datovou sadu, a pokud nevrátí pohlaví, použije běžnou AI. Jde o výchozí nastavení jednotlivých požadavků.	Celkem 1, včetně záložní AI
options.ai_mode: always	Použije přímo AI.	2
forceToGenderize: true	Nejprve prohledá datovou sadu a potom umožní AI vyložit osobní přezdívku nebo alias, i bez skutečného křestního jména.	1 za výsledek z datové sady; celkem 2, pokud se použije AI

Před zvýšením objemu workflow ověřte

Záměrným testem ověřte skutečně serializovaný JSON, cesty ke zpracovaným výsledkům, přístup s API klíčem a potvrzené účtování. Kde je to možné, otestujte zpracování výsledků unknown a chyb pomocí ukázkových odpovědí.
Ujasněte si, které kroky workflow provádějí opakované pokusy a která pole zákazníka se mění. Uchovejte ID zdrojového záznamu, dokončenou odpověď a identifikátor požadavku, aby pozdější chyba v cílové aplikaci nevyžadovala nový požadavek.
Nejprve spusťte malý, kontrolovaný běh a před zvýšením souběžnosti zkontrolujte záznamy a kredity. Kredity GenderAPI a úlohy nebo operace, které účtuje automatizační platforma, jsou samostatné náklady.
Pro dávkový požadavek použijte POST /api/v2/gender/batch s až 50 položkami při přístupu s API klíčem nebo 10 položkami ve zkušebním režimu podle IP. Pole items může kombinovat jména, e-mailové adresy a uživatelská jména, s výslovným nastavením a jedinečným ID pro každou položku. Zkontrolujte každý výsledek: odpověď HTTP 200 může obsahovat chyby jednotlivých položek. Zda nativní konektor podporuje dávkové požadavky, je nutné ověřit zvlášť.

Časté otázky

Mám vložit API klíč do URL ve službě Make?

Ne. V nastavení HTTP pro V2 uložte Bearer YOUR_API_KEY do přihlašovacích údajů pro API klíč s umístěním Header a názvem parametru Authorization. Endpoint POST nepřijímá parametr key v řetězci dotazu.

Pracuje přímý příklad přes HTTP s AI?

Tělo prvního požadavku nastavuje options.ai_mode na off. Hodnotu záměrně změňte na fallback, pokud chcete běžnou záložní AI za celkem 1 kredit, nebo na always, pokud chcete AI použít přímo za 2 kredity. forceToGenderize nejprve prohledá datovou sadu a stojí 1 kredit, pokud se požadavek vyřeší tam, nebo celkem 2 kredity, když se použije AI.

Je výsledek unknown zdarma a lze ho bezpečně automaticky opakovat?

Ne. Úspěšný výsledek unknown je úplný a účtuje se. Opakovaný pokus je nová operace. Při chybách přenosu nebo nepotvrzeném účtování zkontrolujte vrácené údaje o využití a identifikátor požadavku a teprve potom se rozhodněte, zda požadavek odeslat znovu.

Bylo toto workflow spuštěno s připojeným účtem?

Ne. Návody k nastavení platforem byly zkontrolovány podle veřejné dokumentace 26. září 2026. Vysvětlení požadavku a odpovědi GenderAPI.io V2 byla zkontrolována 27. září 2026. Kontrola této české verze 30. září 2026 je kontrolou překladu, nikoli novým testem s účtem. Před zapnutím aktualizací v produkčním prostředí otestujte ve vlastním účtu aktuální pole zvolené akce, autentizaci, tělo požadavku, odpověď a opakované pokusy.

Zdroje a dokumentace

Česká verze byla naposledy zkontrolována 30. září 2026. Údaje o platformách vycházejí z jejich veřejné dokumentace zkontrolované 26. září 2026. Kontrola nebyla novým testem s propojeným účtem. Aktuální nastavení a dostupnost ověřte v oficiální dokumentaci jednotlivých platforem.