# Propojení Zapier s GenderAPI.io V2

> Propojte Zapier s GenderAPI.io V2 pro záznamy v aplikaci Mailchimp. Zvolte správné připojení, pošlete type a value a potom zpracujte data, meta, kredity a chyby.

Canonical HTML: https://www.genderapi.io/cs/blog/zapier-gender-api-integration

Last reviewed: 2026-09-30

## Zvolte připojení ve službě Zapier, 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.

Zapier nabízí akce GenderAPI.io pro určení pohlaví podle jména nebo e-mailové adresy. Veřejná stránka aplikace neurčuje verzi endpointu ani specifikaci odpovědi V2. Než změníte mapování polí v navazujících krocích, je nutné zkontrolovat výstup stávajících nativních akcí.

Nastavení V2 níže používá Webhooks by Zapier se strukturovaným obsahem (payload) pro POST. Přístup k Webhooks vyžaduje placený tarif Zapier. Zůstatek na účtu GenderAPI a úlohy, které spotřebovává samotný Zapier, jsou oddělené.

- [Oficiální stránka aplikace GenderAPI.io ve službě Zapier](https://zapier.com/apps/gender-api/integrations)
- [Stávající dokumentace V1](https://www.genderapi.io/cs/api-documentation/v1)

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

Tento příklad obohacuje záznamy v aplikaci Mailchimp 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í](https://www.genderapi.io/cs/docs/v2/authentication#environment-setup)

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

- Začněte spouštěčem Mailchimp, který poskytuje správný záznam odběratele. Ponechte si ID cílové skupiny (Audience) a kontaktu a před akci HTTP přidejte filtr, který přeskočí prázdné e-mailové adresy.
- Zvolte Webhooks by Zapier a akci POST. Zadejte URL níže a Payload Type: JSON. Přidejte datová pole type = email, value = namapovaná e-mailová adresa odběratele a options__ai_mode = off.
- Zápis s dvojitým podtržítkem ve službě Zapier vnoří options__ai_mode do těla JSON jako options.ai_mode. Blok kódu níže ukazuje tělo, které přijme API. Nejde o čtvrté pole, které byste měli vložit do akce.
- V části Headers přidejte Authorization s hodnotou Bearer YOUR_API_KEY. Jako Content-Type použijte application/json. Klíč nevkládejte do polí spouštěče, řetězců dotazu ani do ukázkových dat odpovědí.

| 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.

**Požadavek V2 v JSON pro Zapier**

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

- [Všechna pole, typy a výchozí hodnoty požadavku](https://www.genderapi.io/cs/docs/v2/request-parameters)

## Před zapnutím aktualizací zkontrolujte krok HTTP

Hlavičky ve Webhooks nejsou samostatným polem pro tajné připojení: vidí je každý, kdo může Zap upravovat. Omezte přístup a nesdílejte Zap, snímek obrazovky ani export, které obsahují přihlašovací údaje. Zapier nabízí také API by Zapier s uloženými přihlašovacími údaji, ale nastavení těla požadavku se tam liší od tohoto postupu se strukturovaným POST.

Tělo nezabalujte: odešlete jeden objekt, ne seznam ani pole. Pro namapovaná data zákazníků zvolte akci se strukturovaným JSON. Custom Request odesílá prostý text a vložené hodnoty automaticky neescapuje.

- [Strukturované požadavky Webhooks a vnořený JSON ve službě Zapier](https://help.zapier.com/hc/en-us/articles/8496326446989-Send-webhooks-in-Zap-workflows)
- [Připojení s přihlašovacími údaji v API by Zapier](https://help.zapier.com/hc/en-us/articles/44391660158733-How-to-get-started-with-API-by-Zapier)
- [Jak funguje opakování (Replay) ve službě Zapier](https://help.zapier.com/hc/en-us/articles/19220226086797-What-is-replay)

## 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. |

- [Úplná reference odpovědi V2](https://www.genderapi.io/cs/docs/v2/responses)
- [Rozhodování při chybách, vypršení časového limitu a opakování](https://www.genderapi.io/cs/docs/v2/errors-and-retries)

## Aktualizujte jen odpovídající záznam v aplikaci Mailchimp

Zkontrolujte zpracovanou odpověď testovací akce a vyberte pole, která odpovídají data.gender, data.result_status a dalším cestám V2 níže. Výběr polí ve službě Zapier může označení vnořených polí zploštit: vycházejte z pozorované hodnoty a nadřazené cesty a nepředpokládejte, že platí starší pole probability nativního konektoru.

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á.

- [Pole odpovědi a neznámé výsledky](https://www.genderapi.io/cs/docs/v2/responses)
- [Vysvětlení přesnosti a spolehlivosti](https://www.genderapi.io/cs/accuracy-methodology)
- [Zdroje dat a datovaný profil datové sady](https://www.genderapi.io/cs/data-provenance)

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

Než Zap zapnete, zkontrolujte nastavení Autoreplay a ručního opakování (Replay) ve službě Zapier. Opakování neúspěšné akce webhooku odešle nový požadavek. Úspěšný požadavek by se neměl spouštět znovu jen kvůli opravě pozdějšího kroku v aplikaci Mailchimp. Původní ID odběratele a výsledek požadavku ukládejte společně.

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í](https://www.genderapi.io/cs/docs/v2/credits-and-usage)

## 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 |

- [Možnosti AI a analýza přezdívek](https://www.genderapi.io/cs/docs/v2/ai-options)
- [Kredity a využití](https://www.genderapi.io/cs/docs/v2/credits-and-usage)

## 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ášť.

- [Dávkové požadavky a chyby jednotlivých položek](https://www.genderapi.io/cs/docs/v2/batch)
- [Průvodce implementací pro Python](https://www.genderapi.io/cs/integrations/python)
- [Průvodce implementací pro Node.js](https://www.genderapi.io/cs/integrations/javascript)

## Proč nastavení ve službě Zapier používá options__ai_mode?

Strukturovaná akce POST ve Webhooks používá dvojitá podtržítka k vytvoření vnořeného JSON. API přijme options: {ai_mode: off}, kde off je řetězec. Nepřijme doslovné pole options__ai_mode na nejvyšší úrovni.

## 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

- [Oficiální stránka aplikace GenderAPI.io ve službě Zapier](https://zapier.com/apps/gender-api/integrations)
- [Strukturované požadavky Webhooks a vnořený JSON ve službě Zapier](https://help.zapier.com/hc/en-us/articles/8496326446989-Send-webhooks-in-Zap-workflows)
- [Připojení s přihlašovacími údaji v API by Zapier](https://help.zapier.com/hc/en-us/articles/44391660158733-How-to-get-started-with-API-by-Zapier)
- [Jak funguje opakování (Replay) ve službě Zapier](https://help.zapier.com/hc/en-us/articles/19220226086797-What-is-replay)
- [Specifikace požadavku v GenderAPI.io V2](https://www.genderapi.io/cs/docs/v2/request-parameters)
- [Specifikace odpovědi v GenderAPI.io V2](https://www.genderapi.io/cs/docs/v2/responses)
- [Účtování a kredity v GenderAPI.io V2](https://www.genderapi.io/cs/docs/v2/credits-and-usage)