# Połącz GenderAPI.io V2 z Pabbly Connect

> Połącz Pabbly Connect z GenderAPI.io V2 dla rekordów w aplikacji Shopify. 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/pabbly-gender-api-integration

Last reviewed: 2026-09-28

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

Publiczny katalog Pabbly zawiera aplikację o nazwie Gender API, ale sprawdzona pozycja nie podaje domeny dostawcy, wersji endpointu ani pełnego schematu odpowiedzi. Sama nazwa nie dowodzi, że chodzi o GenderAPI.io. Zanim wybierzesz akcję natywną, zweryfikuj dostawcę i rzeczywiste pola.

Aby korzystać z jawnego endpointu V2, użyj funkcji niestandardowego zapytania API w API by Pabbly. Ten przepis opisuje to zapytanie HTTP; nie twierdzi, że natywny konektor został przeniesiony na V2.

- [Pozycja w katalogu Pabbly (dostawca niezweryfikowany)](https://connect.pabbly.com/integrations/gender-api/)
- [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 Shopify 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 Pabbly Connect

- Wybierz wyzwalacz Shopify odpowiadający potrzebnemu zdarzeniu klienta i przechwyć reprezentatywny rekord testowy. Zachowaj identyfikator klienta i zmapuj dostępne pole imienia. Pomiń puste imię zamiast zastępować je całym rekordem klienta.
- Dodaj API by Pabbly i wybierz Custom Request. Wybierz POST i poniższy adres URL V2. Skonfiguruj uwierzytelnianie Bearer token z kluczem GenderAPI albo nagłówek Authorization, którego pełna wartość to Bearer YOUR_API_KEY; nie konfiguruj obu mechanizmów jednocześnie.
- Ustaw Content-Type na application/json. Custom Request udostępnia pole Data na treść JSON. Zbuduj obiekt z type = name, value = zmapowane imię oraz obiektem options zawierającym ai_mode = off. Nagłówek Content-Type opisuje deklarowaną treść; sam w sobie nie zamienia pól formularza w obiekt JSON.
- Pozostaw options zagnieżdżone. Jeśli wybrana akcja przyjmuje tylko surowy JSON, upewnij się, że cudzysłowy, ukośniki odwrotne i znaki końca wiersza w zmapowanych wartościach są prawidłowo zakodowane w JSON; zamiast wstawiać niezakodowany tekst klienta, użyj obsługiwanego kroku budowania JSON.

| 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 Pabbly Connect**

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

Sprawdź przechwyconą treść odpowiedzi i upewnij się, że następny krok odczytuje treść V2, a nie pola stanu transportu. Pabbly może udostępniać klucze odpowiedzi do późniejszego mapowania; sprawdź ich rzeczywistą ścieżkę w swoim przepływie pracy.

Podczas konfiguracji uruchamiaj tylko wybraną akcję testową. Test, który wysyła zapytanie, może zużyć kredyty GenderAPI i zadania platformy jeszcze przed włączeniem przepływu pracy.

- [Wsparcie Pabbly: Custom Request i pole JSON Data](https://forum.pabbly.com/threads/cannot-access-json-body-field-in-api-by-pabbly-module-even-after-correct-settings.29297/)
- [Pozycja w publicznym katalogu Pabbly (dostawca niezweryfikowany)](https://connect.pabbly.com/integrations/gender-api/)

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

Zachowaj identyfikator klienta Shopify dostarczony przez wyzwalacz. Kieruj potwierdzone wyniki identified do zaplanowanego pola klienta lub zgodnie z polityką tagów, zachowuj wyniki unknown jako unknown i nie zmieniaj imienia podanego przez klienta. Przy każdej zaakceptowanej prognozie zapisuj source i confidence_kind.

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

Pabbly dokumentuje Auto Re-execution oraz ręczne opcje ponownego wykonania kroków zakończonych błędem lub pominiętych albo całego przepływu pracy. Przed użyciem którejkolwiek z tych opcji sprawdź, co zostanie wykonane. Ponowne wykonanie całego przepływu pracy może powtórzyć już zakończone zapytanie GenderAPI; jeśli to możliwe, naprawiaj późniejszy błąd w Shopify na podstawie zapisanej odpowiedzi.

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 w Pabbly mogę użyć płaskiego pola formularza options.ai_mode?

Treść POST V2 wymaga obiektu JSON options. Kropka w etykiecie pola sama w sobie nie dowodzi, że platforma tworzy obiekt zagnieżdżony. Przed wysłaniem zapytania sprawdź zserializowaną treść i upewnij się, że odpowiada przykładowi.

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

- [Wsparcie Pabbly: niestandardowe zapytania REST i ponowne wykonanie](https://forum.pabbly.com/threads/how-to-track-node-level-logs-enable-retries-and-use-rest-api-integrations-in-pabbly-connect.214474/)
- [Wsparcie Pabbly: Custom Request i pole JSON Data](https://forum.pabbly.com/threads/cannot-access-json-body-field-in-api-by-pabbly-module-even-after-correct-settings.29297/)
- [Pozycja w publicznym katalogu Pabbly (dostawca niezweryfikowany)](https://connect.pabbly.com/integrations/gender-api/)
- [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)