# Połącz GenderAPI.io V2 z Zapier

> Połącz Zapier z GenderAPI.io V2 dla rekordów w aplikacji Mailchimp. Wybierz właściwy konektor, wyślij type i value, a następnie obsłuż data, meta, kredyty i błędy.

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

Last reviewed: 2026-09-28

## Wybierz połączenie Zapier zgodne z Twoim kontraktem API

Przepis HTTP z tego poradnika wywołuje GenderAPI.io V2 pod adresem https://api.genderapi.io/api/v2/gender. Wyślij type i value w treści JSON; prognozę odczytasz z data, a informacje o zapytaniu i rozliczeniu z meta. Wbudowane konektory mają własne kontrakty, opisane poniżej.

Zapier udostępnia akcje GenderAPI.io do określania płci na podstawie imienia lub adresu e-mail. Publiczna karta nie określa wersji endpointu ani kontraktu odpowiedzi V2. Zanim zmienisz mapowania w dalszych krokach, sprawdź dane wyjściowe istniejących akcji natywnych.

Poniższa konfiguracja V2 korzysta z Webhooks by Zapier ze strukturalnym zapytaniem POST. Webhooks by Zapier wymaga płatnego planu Zapier. Saldo konta GenderAPI i zadania zużywane w Zapier są rozliczane osobno.

- [Karta aplikacji GenderAPI.io w Zapier](https://zapier.com/apps/gender-api/integrations)
- [Istniejąca dokumentacja V1](https://www.genderapi.io/pl/api-documentation/v1)

## Przygotuj konto i rekord źródłowy

Ten przykład wzbogaca rekordy w aplikacji Mailchimp na podstawie adresu e-mail. Potrzebujesz dostępu do aplikacji źródłowej i docelowej, klucza konta GenderAPI.io oraz funkcji platformy używanych przez akcję HTTP. Ten poradnik nie zawiera działających danych uwierzytelniających ani połączonych kont.

V1 i V2 korzystają z tego samego klucza konta i tego samego salda. Zanim skonfigurujesz płatne zapytanie, sprawdź klucz za pomocą GET /api/v2/usage i upewnij się, że w odpowiedzi tego endpointu meta.access.mode ma wartość api_key. Brakujący lub nierozpoznany klucz może spowodować przejście na wspólną próbę dla adresu IP; produkcyjna automatyzacja nie powinna niepostrzeżenie z niej korzystać.

Podczas konfiguracji pozostaw przepływ pracy wyłączony. Testowa prognoza zużywa zwykłe kredyty. Te instrukcje zostały sprawdzone na podstawie publicznej dokumentacji i kontraktu V2; na potrzeby tej publikacji nie uruchomiono od początku do końca uwierzytelnionego przepływu pracy na żadnej platformie.

- [Uwierzytelnianie i bezpłatne sprawdzenie zużycia](https://www.genderapi.io/pl/docs/v2/authentication#environment-setup)

## Skonfiguruj zapytanie GenderAPI.io V2 w Zapier

- Zacznij od wyzwalacza Mailchimp, który dostarcza właściwy rekord subskrybenta. Zachowaj identyfikatory odbiorców (audience) i kontaktu, a przed akcją HTTP dodaj filtr pomijający puste adresy e-mail.
- Wybierz Webhooks by Zapier i akcję POST. Podaj poniższy adres URL i Payload Type: JSON. Dodaj pola danych type = email, value = zmapowany adres e-mail subskrybenta oraz options__ai_mode = off.
- Notacja z podwójnym podkreślnikiem w Zapier zagnieżdża options__ai_mode jako options.ai_mode w treści JSON. Poniższy blok kodu pokazuje treść otrzymywaną przez API; nie jest to czwarte pole do wklejenia w akcji.
- W sekcji Headers dodaj Authorization z wartością Bearer YOUR_API_KEY. Jako Content-Type użyj application/json. Nie umieszczaj klucza w polach wyzwalacza, w ciągu zapytania ani w przykładowych odpowiedziach.

| Ustawienie HTTP | Wartość | Przeznaczenie |
| --- | --- | --- |
| `Method` | `POST` | Wysyła pojedyncze zapytanie o prognozę. |
| `URL` | `https://api.genderapi.io/api/v2/gender` | Endpoint V2 GenderAPI.io do pojedynczych prognoz. |
| `Authorization` | `Bearer YOUR_API_KEY` | Zastąp symbol zastępczy za pomocą ustawień uwierzytelniania lub nagłówków platformy. |
| `Content-Type` | `application/json` | Wysyła obiekt z zagnieżdżonym obiektem options, a nie pola formularza. |
| `options.ai_mode` | `off` | Pierwszy świadomy test ograniczony do zbioru danych: zwykłe obciążenie 1 kredytem, nawet jeśli wynik to unknown. |

## Sprawdź treść JSON przed wysłaniem

Ten przykład ilustruje stałe dane wejściowe; nie jest to prognozowany wynik. Najpierw sprawdź strukturę zapytania, a następnie zastąp value zmapowanym polem źródłowym, stosując prawidłową serializację JSON. Nie wysyłaj do API wyrażeń mapowania platformy jako dosłownego tekstu.

W przypadku innych danych wejściowych ustaw type na name, email lub username i podaj odpowiednią wartość w value. Dodaj country tylko wtedy, gdy masz wiarygodny kontekst: to pole jest opcjonalne i nie służy do ustalania kraju zamieszkania.

**Zapytanie JSON V2 dla Zapier**

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

- [Pola zapytania, typy i wartości domyślne](https://www.genderapi.io/pl/docs/v2/request-parameters)

## Sprawdź krok HTTP przed włączeniem aktualizacji

Nagłówki Webhooks nie są dedykowanym polem na sekrety: widzą je osoby, które mogą edytować Zap. Ogranicz dostęp i nie udostępniaj Zapa, zrzutu ekranu ani eksportu zawierającego dane uwierzytelniające. Zapier oferuje też API by Zapier z zapisanymi danymi uwierzytelniającymi, ale konfiguracja treści zapytania różni się tam od tego ustrukturyzowanego przepisu POST.

Nie opakowuj treści: wysyłaj pojedynczy obiekt, a nie listę ani tablicę. Dla zmapowanych danych klienta wybieraj strukturalną akcję JSON; Custom Request wysyła surowy tekst i nie zmienia automatycznie znaków specjalnych we wstawianych wartościach.

- [Strukturalne zapytania Webhooks i zagnieżdżony JSON w Zapier](https://help.zapier.com/hc/en-us/articles/8496326446989-Send-webhooks-in-Zap-workflows)
- [Połączenia z danymi uwierzytelniającymi w API by Zapier](https://help.zapier.com/hc/en-us/articles/44391660158733-How-to-get-started-with-API-by-Zapier)
- [Działanie ponawiania (replay) w Zapier](https://help.zapier.com/hc/en-us/articles/19220226086797-What-is-replay)

## Rozdziel wyniki identified, unknown i błędy

Przeanalizuj treść odpowiedzi, zanim wybierzesz aktualizację docelową. Poniższe ścieżki JSON dotyczą treści odpowiedzi V2; Twoja platforma może ją opakować lub spłaszczyć. Potwierdź rzeczywiście zwracaną strukturę w celowym teście i przechowuj wynik razem z identyfikatorem rekordu źródłowego.

Prognoza nie ustala tożsamości osoby ani płci, którą ta osoba deklaruje. Przechowuj ją oddzielnie od informacji podanych przez samą osobę. Kryteria akceptacji określ na podstawie reprezentatywnych danych z własnego zastosowania i oceniaj osobno pewność pochodzącą ze zbioru danych oraz pewność AI.

| Kontrola | Oczekiwana wartość lub typ | Decyzja w przepływie pracy |
| --- | --- | --- |
| `meta.access.mode` | api_key dla tego przepływu pracy konta | Zatrzymaj przepływ pracy, jeśli wartość to ip_trial, i popraw klucz. Udana odpowiedź w ramach próby nie dowodzi uwierzytelnienia konta i mogła już zużyć kredyty próbne. |
| `meta.usage.billing_status` | confirmed lub unconfirmed | Jeśli wartość to unconfirmed, zachowaj identyfikator zapytania i doprowadź do uzgodnienia rozliczenia przed ponowną próbą lub kontynuacją. |
| `data.result_status / data.gender` | identified z male lub female; unknown z null | Zapisuj zaakceptowane wyniki identified w osobnym polu wnioskowania. Zachowuj wyniki unknown bez przypisywania kategorii domyślnej. |
| `data.confidence / data.confidence_kind` | liczba od 0 do 1 lub null; rodzaj dowodu lub null | Interpretuj observed_frequency i model_reported oddzielnie; żadna z tych wartości nie gwarantuje uniwersalnej dokładności. |
| `data.source / data.sample_count` | dataset, ai lub none / liczba całkowita lub null | Zachowaj informację o pochodzeniu prognozy. AI nie ma zapisanej liczby próbek; liczba próbek ze zbioru danych nie jest miarą dokładności produktu. |
| `meta.request_id / meta.usage` | odniesienie do zapytania / obiekt zużycia | Zapisz je razem z rekordem przepływu pracy i wynikiem. Nie umieszczaj kluczy API ani zbędnych danych osobowych w rutynowych logach. |
| `Błąd HTTP / brak odpowiedzi` | Problem Details lub brak pełnej odpowiedzi | Wstrzymaj aktualizację i sprawdź błąd oraz stan rozliczenia. Przekroczenie limitu czasu nie dowodzi, że serwer niczego nie przetworzył. |

- [Pełna dokumentacja odpowiedzi V2](https://www.genderapi.io/pl/docs/v2/responses)
- [Błędy i decyzje o ponownych próbach](https://www.genderapi.io/pl/docs/v2/errors-and-retries)

## Aktualizuj tylko właściwy rekord w aplikacji Mailchimp

Sprawdź przeanalizowaną odpowiedź akcji testowej i wybierz pola odpowiadające data.gender, data.result_status oraz pozostałym ścieżkom V2 podanym powyżej. Selektor Zapier może spłaszczać zagnieżdżone etykiety: korzystaj z zaobserwowanej wartości i ścieżki nadrzędnej, zamiast zakładać starsze pole probability natywnego konektora. Aktualizuj wyłącznie subskrybenta Mailchimp, którego identyfikator został zachowany.

Przetestuj gałęzie dla wyniku identified, wyniku unknown i błędu, zanim włączysz aktualizacje. Fikcyjne przykładowe odpowiedzi pozwalają sprawdzić warunki rozgałęzień bez wysyłania nowej prognozy. Aktualizacja w aplikacji docelowej powinna zależeć od powyższych kontroli i nie może nadpisywać niepowiązanych pól ani etykiet.

- [Pola odpowiedzi i wyniki unknown](https://www.genderapi.io/pl/docs/v2/responses)
- [Dokładność i pewność wyników](https://www.genderapi.io/pl/accuracy-methodology)
- [Źródła danych i datowany profil bazy danych](https://www.genderapi.io/pl/data-provenance)

## Kontroluj ponowienia i powtórne obciążenia

Przed włączeniem Zapa sprawdź ustawienia Autoreplay i ręcznego ponawiania (replay) w Zapier. Ponowienie nieudanej akcji webhook wysyła nowe zapytanie; nie ponawiaj udanego zapytania tylko po to, aby naprawić późniejszy krok w Mailchimp. Przechowuj razem pierwotne identyfikatory subskrybenta i wynik zapytania.

Każde nowe zapytanie do GenderAPI jest niezależną operacją. Deduplikuj powtórzone zdarzenia źródłowe we własnym przepływie pracy przed wysłaniem, korzystając z zapisanego identyfikatora źródłowego i stanu przetwarzania. Identyfikator rekordu źródłowego nie jest kluczem, który chroni przed ponowieniami po stronie serwera.

Udany wynik unknown jest kompletnym i płatnym wynikiem. Gdy upłynie limit czasu lub odpowiedź będzie niepełna, wynik i obciążenie mogą być nieznane: zachowaj referencję zapytania, jeśli jest dostępna, i uzgodnij rozliczenie przed ponownym wysłaniem zapytania. Przestrzegaj nagłówka Retry-After, gdy towarzyszy odpowiedzi o przekroczeniu limitu zapytań.

- [Kredyty i stany rozliczenia](https://www.genderapi.io/pl/docs/v2/credits-and-usage)

## Zdecyduj, kiedy korzystać z AI

forceToGenderize jest opcjonalne dla imion, adresów e-mail i nazw użytkowników. Gdy jest włączone, pomiń ai_mode lub użyj fallback; off i always są z nim sprzeczne i zwracają 422. Dodatnie saldo początkowe wystarcza do rozpoczęcia zapytania, nawet jeśli ostateczne obciążenie obniży saldo poniżej zera.

Tryb pseudonimów może zwrócić płeć razem z name: null. Może też zwrócić wynik unknown. Ani standardowe przejście na AI, ani analiza pseudonimów nie gwarantują poprawnej odpowiedzi ani wartości innej niż null.

| Opcja zapytania | Działanie | Kredyty za udane wyszukiwanie |
| --- | --- | --- |
| options.ai_mode: off | Korzysta tylko ze zbioru danych. | 1, także przy wyniku unknown |
| options.ai_mode: fallback | Najpierw sprawdza zbiór danych, a gdy nie zwróci on płci, korzysta ze standardowej AI. To ustawienie domyślne dla pojedynczych zapytań. | Łącznie 1, łącznie z przejściem na AI |
| options.ai_mode: always | Od razu korzysta z AI. | 2 |
| forceToGenderize: true | Najpierw sprawdza zbiór danych, a potem pozwala AI zinterpretować osobisty pseudonim lub alias, nawet bez prawdziwego imienia. | 1 za wynik rozstrzygnięty w zbiorze danych; łącznie 2, jeśli użyta zostanie AI |

- [Opcje AI i analiza pseudonimów](https://www.genderapi.io/pl/docs/v2/ai-options)
- [Kredyty i zużycie](https://www.genderapi.io/pl/docs/v2/credits-and-usage)

## Zweryfikuj przepływ pracy przed zwiększeniem wolumenu

- W jednym celowym teście sprawdź rzeczywiście zserializowany JSON, przeanalizowane ścieżki wyników, dostęp za pomocą klucza API i potwierdzenie rozliczenia. Tam, gdzie to możliwe, przetestuj obsługę wyników unknown i błędów na przykładowych odpowiedziach.
- Ustal, które kroki przepływu pracy są ponawiane i które pola klienta się zmieniają. Zachowaj identyfikator rekordu źródłowego, uzyskaną odpowiedź i odniesienie do zapytania, aby późniejszy błąd w systemie docelowym nie wymagał kolejnego zapytania.
- Najpierw włącz małe, kontrolowane uruchomienie i sprawdź jego rekordy oraz kredyty, zanim zwiększysz współbieżność. Kredyty GenderAPI oraz zadania lub operacje rozliczane przez platformę automatyzacji to odrębne koszty.
- W przypadku partii użyj POST /api/v2/gender/batch z maksymalnie 50 elementami przy dostępie za pomocą klucza API lub 10 w próbie dla adresu IP. Tablica items może łączyć imiona, adresy e-mail i nazwy użytkowników, z jawnymi opcjami i unikalnym identyfikatorem dla każdego elementu. Sprawdź każdy wynik: odpowiedź HTTP 200 może zawierać częściowe błędy. Obsługę partii przez natywny konektor trzeba sprawdzić osobno.

- [Partie i częściowe błędy](https://www.genderapi.io/pl/docs/v2/batch)
- [Przewodnik implementacji w Pythonie](https://www.genderapi.io/pl/integrations/python)
- [Przewodnik implementacji w Node.js](https://www.genderapi.io/pl/integrations/javascript)

## Dlaczego konfiguracja Zapier używa options__ai_mode?

Strukturalna akcja POST w Webhooks używa podwójnego podkreślnika do tworzenia zagnieżdżonego JSON. API otrzymuje options: {ai_mode: off}, gdzie off jest ciągiem znaków. Nie otrzymuje dosłownego pola options__ai_mode na najwyższym poziomie.

## Czy bezpośredni przykład HTTP dopuszcza użycie AI?

Treść pierwszego zapytania ustawia options.ai_mode na off. Świadomie zmień tę wartość na fallback, aby korzystać ze standardowego przejścia na AI za łącznie 1 kredyt, lub na always, aby od razu korzystać z AI za 2 kredyty. forceToGenderize najpierw sprawdza zbiór danych: kosztuje 1 kredyt, jeśli zapytanie zostanie w nim rozstrzygnięte, lub łącznie 2, gdy zostanie użyta AI.

## Czy wynik unknown jest bezpłatny i czy można go bezpiecznie ponawiać automatycznie?

Nie. Udany wynik unknown jest kompletny i płatny. Ponowienie jest nową operacją. W przypadku błędu transportu lub niepotwierdzonego rozliczenia sprawdź zwrócone dane o zużyciu i odniesienie do zapytania, zanim zdecydujesz o ponownym wysłaniu zapytania.

## Czy ten przepływ pracy został uruchomiony na połączonym koncie?

Nie. Instrukcje konfiguracji platform zostały sprawdzone 26 września 2026 r. na podstawie ich publicznej dokumentacji. Wyjaśnienia dotyczące zapytania i odpowiedzi GenderAPI.io V2 zostały sprawdzone 27 września 2026 r. Rewizja tej polskiej wersji z 28 września 2026 r. dotyczy tłumaczenia i nie jest nowym testem na koncie. Zanim włączysz aktualizacje produkcyjne, przetestuj na własnym koncie bieżące pola wybranej akcji, uwierzytelnianie, treść zapytania, odpowiedź i ponowne próby.

## Dokumentacja źródłowa

- [Karta aplikacji GenderAPI.io w Zapier](https://zapier.com/apps/gender-api/integrations)
- [Strukturalne zapytania Webhooks i zagnieżdżony JSON w Zapier](https://help.zapier.com/hc/en-us/articles/8496326446989-Send-webhooks-in-Zap-workflows)
- [Połączenia z danymi uwierzytelniającymi w API by Zapier](https://help.zapier.com/hc/en-us/articles/44391660158733-How-to-get-started-with-API-by-Zapier)
- [Działanie ponawiania (replay) w Zapier](https://help.zapier.com/hc/en-us/articles/19220226086797-What-is-replay)
- [Kontrakt zapytania GenderAPI.io V2](https://www.genderapi.io/pl/docs/v2/request-parameters)
- [Kontrakt odpowiedzi GenderAPI.io V2](https://www.genderapi.io/pl/docs/v2/responses)
- [Rozliczenia i kredyty GenderAPI.io V2](https://www.genderapi.io/pl/docs/v2/credits-and-usage)