# Propojení Integrately s GenderAPI.io V2

> Propojte Integrately 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/integrately-gender-api-integration

Last reviewed: 2026-09-30

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

Stránka GenderAPI.io ve službě Integrately odkazuje na genderapi.io a nabízí akce pro jména, e-mailové adresy a získání křestního jména z e-mailové adresy. Neuvádí verzi základního API ani úplné schéma výstupu. Samotné názvy akcí nedokazují kompatibilitu s V2.

Integrately dokumentuje Webhook/API jako odchozí akci POST. Aktuální ovládací prvky pro hlavičky a editor JSON nebyly pro tento návod nezávisle ověřeny. Specifikaci HTTP pro V2 níže použijte až poté, co ověříte, že vaše akce umí odeslat hlavičku Authorization a vnořené tělo JSON. Stávající nativní akce si zachovávají vlastní specifikaci polí.

- [Oficiální stránka GenderAPI.io ve službě Integrately](https://integrately.com/integrations/genderapi-io)
- [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 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.

- [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ě Integrately

- Zvolte spouštěč Mailchimp pro odběratele a zkontrolujte jeden testovací záznam. Pro aktualizaci si ponechte ID cílové skupiny (Audience) a odběratele, vyberte skutečné pole křestního jména a záznamy bez jména přeskočte.
- Najděte Webhook/API a akci pro odeslání dat na URL. Než budete pokračovat, zkontrolujte dostupné nastavení: specifikace níže vyžaduje autentizované hlavičky a vnořené tělo JSON a aktuální ovládací prvky editoru zde nebyly nezávisle ověřeny.
- Pokud akce tyto požadavky splňuje, zvolte POST a endpoint V2 níže. Pomocí ovládacích prvků dostupných ve vašem účtu zajistěte, aby odchozí požadavek obsahoval Authorization: Bearer YOUR_API_KEY a Content-Type: application/json.
- Sestavte tělo JSON s type = name, value = namapované křestní jméno a options s ai_mode = off. Zkontrolujte náhled požadavku u zvolené akce: plochý obsah formuláře není tělo JSON pro V2.
- Pro dynamická jména použijte ovládací prvky platformy pro mapování nebo serializaci JSON. Pokud zvolená akce nedokáže zachovat vnořený JSON nebo autentizované hlavičky, použijte krok s podporou HTTP, místo abyste klíč nebo JSON vkládali do parametrů v řetězci dotazu.

| 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 Integrately**

```json
{
  "type": "name",
  "value": "Alice",
  "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

Záměrně otestujte jednu akci a před výběrem polí pro navazující kroky zkontrolujte vrácené tělo. Nativní kroky GenderAPI.io a kroky Webhook/API mohou zobrazovat odlišná označení polí, i když je zdrojový zákazník stejný.

Klíč uchovávejte v ovládacích prvcích určených pro připojení nebo autentizaci požadavku a omezte, kdo může automatizaci zobrazit nebo sdílet. Tento veřejný návod neobsahuje funkční klíč, exportované připojení ani předem nakonfigurovanou aktualizaci zákazníků.

- [Akce Webhook/API ve službě Integrately](https://integrately.com/integrations/webhook-api)
- [Dokumentace Integrately](https://integrately.com/docs)

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

K výběru cílového záznamu použijte uložená ID cílové skupiny (Audience) a odběratele v aplikaci Mailchimp. Než zapíšete do samostatného pole pro odvozené údaje nebo schváleného štítku, přidejte podmínky pro stav výsledku a pro kontroly přístupu a účtování níže. Chybějící pohlaví ani hodnotu null nikdy neměňte na výchozí kategorii kontaktu.

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í

Integrately dokumentuje automatické opakování, včetně nastavení platných pro celou společnost. Před zapnutím této automatizace zkontrolujte pravidla a historii úloh a před změnou sdíleného nastavení posuďte dopad na ostatní workflow. Každý opakovaný požadavek HTTP je samostatný požadavek, který se účtuje. Uchovávejte úspěšné výstupy, aby bylo možné pozdější chybu v aplikaci Mailchimp opravit bez nového 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í](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)

## Mohu pole probability ze staré nativní akce namapovat na confidence ve V2?

Nejprve si projděte specifikaci odpovědi. Přímý požadavek V2 vrací data.confidence spolu s data.confidence_kind na stupnici od 0 do 1 nebo jako null. Nepředpokládá se, že označení polí a stupnice nativního konektoru těmto cestám odpovídají.

## 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 GenderAPI.io ve službě Integrately](https://integrately.com/integrations/genderapi-io)
- [Akce Webhook/API ve službě Integrately](https://integrately.com/integrations/webhook-api)
- [Dokumentace Integrately](https://integrately.com/docs)
- [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)