# Połącz GenderAPI.io V2 z Integrately

> Połącz Integrately 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/integrately-gender-api-integration

Last reviewed: 2026-09-28

## Wybierz połączenie Integrately 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.

Karta GenderAPI.io w Integrately prowadzi do genderapi.io i oferuje akcje dla imion, adresów e-mail oraz wyodrębniania imienia z adresu e-mail. Nie podaje bazowej wersji API ani pełnego schematu danych wyjściowych; same nazwy akcji nie wystarczają do potwierdzenia zgodności z V2.

Integrately dokumentuje Webhook/API jako wychodzącą akcję POST. Jej bieżące kontrolki nagłówków i edytora JSON nie zostały niezależnie zweryfikowane na potrzeby tego przewodnika. Stosuj poniższy kontrakt HTTP V2 dopiero po potwierdzeniu, że Twoja akcja może wysłać nagłówek Authorization i zagnieżdżoną treść JSON. Istniejące akcje natywne zachowują własny kontrakt pól.

- [Karta GenderAPI.io w Integrately](https://integrately.com/integrations/genderapi-io)
- [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 imienia. 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 Integrately

- Wybierz wyzwalacz subskrybenta Mailchimp i sprawdź jeden rekord testowy. Zachowaj identyfikatory odbiorców (audience) i subskrybenta na potrzeby aktualizacji, wybierz rzeczywiste pole imienia i pomijaj rekordy bez imienia.
- Znajdź Webhook/API i jego akcję wysyłania danych na adres URL. Zanim przejdziesz dalej, sprawdź dostępną konfigurację: poniższy kontrakt wymaga uwierzytelnionych nagłówków i zagnieżdżonej treści JSON, a bieżące kontrolki edytora nie zostały tutaj niezależnie zweryfikowane.
- Jeśli akcja spełnia te wymagania, wybierz POST i poniższy endpoint V2. Zadbaj, aby wychodzące zapytanie zawierało Authorization: Bearer YOUR_API_KEY i Content-Type: application/json, korzystając z kontrolek dostępnych na Twoim koncie.
- Zbuduj treść JSON z type = name, value = zmapowane imię oraz options zawierającym ai_mode = off. Sprawdź podgląd zapytania wybranej akcji: płaski ładunek formularza nie jest treścią JSON V2, nawet jeśli nagłówek Content-Type jest ustawiony.
- Dla dynamicznych imion korzystaj z kontrolek mapowania lub serializacji JSON platformy. Jeśli wybrana akcja nie może zachować zagnieżdżonego JSON lub uwierzytelnionych nagłówków, użyj kroku obsługującego HTTP zamiast umieszczać klucz lub JSON w parametrach zapytania.

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

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

Celowo przetestuj jedną akcję i sprawdź zwróconą treść, zanim wybierzesz pola w dalszych krokach. Natywne kroki GenderAPI.io i kroki Webhook/API mogą wyświetlać różne etykiety pól, nawet dla tego samego klienta źródłowego.

Przechowuj klucz w przeznaczonych do tego kontrolkach połączenia lub uwierzytelniania zapytań i ogranicz krąg osób, które mogą wyświetlać lub udostępniać automatyzację. Ten publiczny przewodnik nie zawiera działającego klucza, wyeksportowanego połączenia ani wstępnie skonfigurowanej aktualizacji klienta.

- [Akcje Webhook/API w Integrately](https://integrately.com/integrations/webhook-api)
- [Dokumentacja Integrately](https://integrately.com/docs)

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

Użyj zapisanych identyfikatorów odbiorców (audience) i subskrybenta Mailchimp, aby wybrać rekord docelowy. Zanim zapiszesz dane w osobnym polu wnioskowania lub zatwierdzonym tagu, dodaj warunki dotyczące stanu wyniku oraz opisanych powyżej kontroli dostępu i rozliczenia. Nigdy nie zamieniaj brakującej płci ani wartości null w domyślną kategorię kontaktu.

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

Integrately dokumentuje automatyczne ponawianie, w tym ustawienia obowiązujące w całej firmie. Przed włączeniem tej automatyzacji sprawdź zasady i historię zadań, a przed zmianą wspólnego ustawienia oceń wpływ na inne przepływy pracy. Każde powtórzone zapytanie HTTP jest niezależnym, płatnym zapytaniem; zachowuj udane dane wyjściowe, aby móc naprawić późniejszy błąd w Mailchimp bez kolejnego 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)

## Czy mogę zmapować pole probability ze starej akcji natywnej na pole confidence w V2?

Najpierw sprawdź kontrakt odpowiedzi. Bezpośrednie zapytanie V2 zwraca data.confidence razem z data.confidence_kind w skali 0–1 lub null. Nic nie uprawnia do założenia, że etykiety i skala pól natywnego konektora odpowiadają tym ścieżkom.

## 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 GenderAPI.io w Integrately](https://integrately.com/integrations/genderapi-io)
- [Akcje Webhook/API w Integrately](https://integrately.com/integrations/webhook-api)
- [Dokumentacja Integrately](https://integrately.com/docs)
- [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)