# Połącz GenderAPI.io V2 z Make

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

Last reviewed: 2026-09-28

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

Make udostępnia aplikację GenderAPI.io z akcjami dla imion i adresów e-mail. Jej publiczna karta prowadzi do genderapi.io, ale nie podaje dokładnej wersji endpointu ani pełnego schematu odpowiedzi. Zanim zmienisz mapowanie w istniejących scenariuszach, sprawdź rzeczywiste dane wyjściowe wybranego modułu.

Aby uzyskać jawne zachowanie V2, użyj aplikacji HTTP w Make i poniższego zapytania. Ta konfiguracja HTTP nie aktualizuje istniejącego modułu GenderAPI: działające scenariusze utrzymuj osobno, dopóki ich zamiennik nie zostanie sprawdzony.

- [Karta aplikacji GenderAPI.io w Make](https://www.make.com/en/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 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 Make

- Wybierz wyzwalacz klienta Shopify odpowiedni dla Twojego scenariusza i wczytaj reprezentatywny rekord testowy. Zachowaj identyfikator klienta na potrzeby końcowej aktualizacji i pomijaj rekordy z pustym adresem e-mail.
- Dodaj HTTP > Make a request. W bieżącej aplikacji HTTP wybierz uwierzytelnianie API key i utwórz dane uwierzytelniające z wartością klucza Bearer YOUR_API_KEY, lokalizacją Header i nazwą parametru Authorization. Korzystaj z tego magazynu danych uwierzytelniających zamiast umieszczać klucz w adresie URL.
- Ustaw metodę POST i poniższy adres URL. Wybierz application/json dla treści zapytania oraz strukturę danych z polami tekstowymi type i value, a także kolekcją options zawierającą pole tekstowe ai_mode. Ustaw type na email i ai_mode na off, a następnie zmapuj adres e-mail klienta do value.
- Włącz Parse response. Treść zbudowana za pomocą struktury danych Make serializuje zmapowane wartości jako JSON, dlatego imiona lub adresy zawierające cudzysłowy nie wymagają ręcznego łączenia tekstu.

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

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

Dla tego stałego docelowego API HTTPS pozostaw przekierowania wyłączone. Jeśli zmieniasz wersję aplikacji HTTP w Make, ponownie sprawdź ustawienia uwierzytelniania i treści zapytania: ich kontrolki mogą się różnić.

Uruchom jeden celowy test, sprawdź przeanalizowany pakiet odpowiedzi (bundle) i utwórz osobne ścieżki dla zaakceptowanych wyników identified, wyników unknown i błędów operacyjnych, zanim dodasz aktualizację klienta.

- [Konfiguracja aplikacji HTTP w Make](https://apps.make.com/http)
- [Dane uwierzytelniające API key i lokalizacja Header w Make](https://apps.make.com/api-key-authentication-type)
- [Automatyczne ponawianie niekompletnych wykonań w Make](https://help.make.com/automatic-retry-of-incomplete-executions)

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

W przeanalizowanej odpowiedzi HTTP zmapuj ścieżki treści V2 podane powyżej. Make może umieścić treść pod etykietą danych wyjściowych modułu: wybierz zagnieżdżone obiekty data i meta ze sprawdzonego pakietu. Aktualizuj wyłącznie klienta, którego identyfikator został zachowany przez wyzwalacz, w osobnym polu wnioskowania lub zgodnie z ustaloną polityką tagów.

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

Sprawdź procedury obsługi błędów w Make oraz ustawienia niekompletnych wykonań. Niektóre błędy tymczasowe mogą być ponawiane nawet bez jawnej procedury obsługi Retry. Ponowienie modułu HTTP może wysłać kolejne płatne zapytanie. Jeśli zapytanie się powiodło, ale późniejsza aktualizacja w Shopify nie, użyj zapisanych danych wyjściowych, aby naprawić tę aktualizację.

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 mam wkleić klucz API do adresu URL w Make?

Nie. W konfiguracji HTTP V2 zapisz Bearer YOUR_API_KEY w danych uwierzytelniających HTTP typu API key, z lokalizacją Header i Authorization jako nazwą parametru. Endpoint POST nie akceptuje parametru zapytania key.

## 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 Make](https://www.make.com/en/integrations/gender-api)
- [Konfiguracja aplikacji HTTP w Make](https://apps.make.com/http)
- [Dane uwierzytelniające API key i lokalizacja Header w Make](https://apps.make.com/api-key-authentication-type)
- [Automatyczne ponawianie niekompletnych wykonań w Make](https://help.make.com/automatic-retry-of-incomplete-executions)
- [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)