Zvolte připojení ve službě Pabbly Connect, 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.
Veřejný katalog Pabbly obsahuje aplikaci s názvem Gender API, ale zkontrolovaný záznam neuvádí doménu poskytovatele, verzi endpointu ani úplné schéma odpovědi. Samotný název nedokazuje, že jde o GenderAPI.io. Než zvolíte nativní akci, ověřte poskytovatele a skutečná pole.
Pro výslovný endpoint V2 použijte funkci pro vlastní požadavky API v API by Pabbly. Tento postup popisuje uvedený požadavek HTTP. Netvrdí, že nativní konektor byl převeden na V2.
Připravte účet a zdrojový záznam
Tento příklad obohacuje záznamy v aplikaci Shopify podle jména. 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.
Nastavte požadavek GenderAPI.io V2 ve službě Pabbly Connect
- Zvolte spouštěč Shopify, který odpovídá potřebné události zákazníka, a zachyťte jeden reprezentativní testovací záznam. Ponechte si ID zákazníka a namapujte dostupné pole křestního jména (first name). Prázdné jméno přeskočte, místo abyste ho nahradili celým záznamem zákazníka.
- Přidejte API by Pabbly a zvolte Custom Request. Zvolte POST a URL pro V2 níže. Nastavte autentizaci Bearer token se svým API klíčem GenderAPI, nebo hlavičku Authorization, jejíž celá hodnota je Bearer YOUR_API_KEY. Nenastavujte oba mechanismy současně.
- Nastavte Content-Type na application/json. Custom Request nabízí pro tělo JSON pole "Data". Vytvořte objekt s type = name, objektem options s ai_mode = off a value = namapované křestní jméno. Hlavička Content-Type jen popisuje formát zadaného těla a pole formuláře na objekt JSON nepřevádí.
- Ponechte options jako vnořený objekt. Pokud zvolená akce nabízí jen surový JSON, zajistěte, aby uvozovky, zpětná lomítka a zalomení řádků v namapovaných hodnotách byly správně escapovány pro JSON. Místo vkládání neescapovaného textu zákazníka použijte podporovaný krok pro sestavení JSON.
| 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": "name",
"value": "Alice",
"options": {
"ai_mode": "off"
}
}Před zapnutím aktualizací zkontrolujte krok HTTP
Zkontrolujte zachycené tělo odpovědi a zajistěte, aby další krok četl tělo V2, a ne stavová pole přenosu. Pabbly může klíče z odpovědi zpřístupnit pro pozdější mapování. Ověřte jejich skutečnou cestu ve svém workflow.
Během konfigurace postupu spouštějte jen zvolenou testovací akci. Test, který odešle požadavek, může spotřebovat kredity GenderAPI a úlohy platformy ještě předtím, než workflow zapnete.
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
Ponechte si ID zákazníka Shopify ze spouštěče. Potvrzené výsledky identified směrujte do plánovaného pole zákazníka nebo podle pravidel pro štítky, výsledky unknown ponechte jako unknown a jméno, které zákazník sám uvedl, ponechte beze změny. Ke každému přijatému odhadu uložte source a confidence_kind.
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í
Pabbly dokumentuje Auto Re-execution a ruční možnosti opětovného spuštění neúspěšných nebo přeskočených kroků či celého workflow. Než některou z těchto možností použijete, zkontrolujte, co se spustí. Opětovné spuštění celého workflow může zopakovat dokončený požadavek na GenderAPI. Pozdější chybu v aplikaci Shopify pokud možno opravte na základě uložené odpovědi.
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í.
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
Mohu ve službě Pabbly použít ploché pole formuláře options.ai_mode?
Tělo POST ve V2 vyžaduje objekt JSON options. Tečka v označení pole sama o sobě nedokazuje, že platforma pole vnoří. Zkontrolujte serializované tělo a před odesláním požadavku ověřte, že odpovídá příkladu.
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 . Ú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.