Propojení Pipedream s GenderAPI.io V2

Zvolte připojení ve službě Pipedream, 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á komponenta GenderAPI.io ve službě Pipedream, zkontrolovaná 26. září 2026, používá starší základní URL https://api.genderapi.io/api a odesílá name nebo email, volitelné country a API klíč jako parametry v řetězci dotazu. Zveřejněná implementace je konektor V1, nikoli endpoint V2 s JSON.

Stávající nativní akci můžete ponechat s její vlastní specifikací, nebo pro V2 přidat obecný krok HTTP. Nepředpokládejte, že automatická autentizace nativního připojeného účtu je pro tento samostatný požadavek V2 správná: postup výslovně používá hlavičku Bearer.

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

Tento příklad obohacuje záznamy v aplikaci Twilio SendGrid 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ě Pipedream

Zvolte událost nebo plán Twilio SendGrid, které odpovídají vašemu účtu a workflow. Zkontrolujte jeden testovací kontakt, ponechte si jeho stálé ID a před krokem obohacení přeskočte prázdné e-mailové hodnoty. Dostupný interval spouštěče je nastavením platformy, nikoli zárukou GenderAPI.
Přidejte akci Send any HTTP Request, zvolte POST a zadejte URL níže. Nakonfigurujte tělo JSON s type = email, value = e-mail kontaktu a options.ai_mode = off.
Klíč uložte pomocí ovládacích prvků pro přihlašovací údaje nebo proměnné prostředí ve službě Pipedream. Nastavte Authorization na Bearer, za nímž následuje tento tajný klíč, a Content-Type na application/json. Nepoužívejte znovu nativní autentizaci s klíčem v řetězci dotazu a klíč v žádném kroku nevypisujte.
Tělo sestavte jako objekt JSON pomocí ovládacích prvků pro mapování, které akce podporuje. Nesestavujte surový JSON spojováním neescapovaných hodnot kontaktu. Než záměrně spustíte jeden test, zkontrolujte náhled požadavku.

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

Zkontrolujte odpověď, kterou krok HTTP exportuje, a najděte zpracované tělo. Pokud zvolená akce vrací tělo jako text, zpracujte ho jednou a teprve potom čtěte data a meta. Pole data v obálce přenosu není totéž co pole data v těle V2.

Pro workflow založené na kódu s výslovným zpracováním vypršení časového limitu, přesměrování a opakovaných pokusů můžete použít otestovaného průvodce pro Node.js, na kterého odkazujeme níže. Obecná akce a nativní aplikace mohou mít odlišná výchozí nastavení přenosu.

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 Twilio SendGrid

ID kontaktu ze spouštěče udržujte společně se zpracovaným tělem V2. Po provedení kontrol výsledků níže aktualizujte pouze plánovaná vlastní pole ve službě SendGrid. Zachovejte jméno, které kontakt sám uvedl: data.name odvozené z e-mailové adresy je odvozený kandidát, nikoli potvrzená náhrada.

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í

Pipedream dokumentuje automatické opakování od neúspěšného kroku, které závisí na tarifu. Zkontrolujte tato nastavení i případné opakování ve zvolené akci HTTP. Opakovaný pokus v neúspěšném kroku obohacení může vést k novému účtování. Pozdější chybu v cílové aplikaci opravte na základě uloženého výstupu obohacení.

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

Používá nativní akce GenderAPI.io ve službě Pipedream V2?

Veřejná komponenta zkontrolovaná 26. září 2026 používá starší endpointy V1 a autentizaci s klíčem v řetězci dotazu. Pro požadavek V2 použijte výslovný postup přes HTTP pro V2, a pokud se verze zveřejněné komponenty změní, zkontrolujte ji znovu.

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.