# Połącz GenderAPI.io V2 z Pipedream

> Połącz Pipedream z GenderAPI.io V2 dla rekordów w aplikacji Twilio SendGrid. 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/pipedream-gender-api-integration

Last reviewed: 2026-09-28

## Wybierz połączenie Pipedream 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 komponent GenderAPI.io w Pipedream, sprawdzony 26 września 2026 r., korzysta ze starszej bazy https://api.genderapi.io/api i wysyła name lub email, opcjonalnie country oraz klucz API jako parametry zapytania. Ta opublikowana implementacja jest konektorem V1, a nie endpointem JSON V2.

Możesz pozostawić istniejącą akcję natywną z jej własnym kontraktem albo dodać ogólny krok HTTP dla V2. Nie zakładaj, że automatyczne uwierzytelnianie natywnego połączonego konta jest właściwe dla tego odrębnego zapytania V2: przepis jawnie używa nagłówka Bearer.

- [Aplikacja GenderAPI.io w Pipedream](https://pipedream.com/apps/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 Twilio SendGrid 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 Pipedream

- Wybierz zdarzenie lub harmonogram Twilio SendGrid odpowiedni dla Twojego konta i przepływu pracy. Sprawdź jeden kontakt testowy, zachowaj jego stały identyfikator i pomijaj puste adresy e-mail przed krokiem wzbogacania. Dostępny interwał wyzwalacza jest ustawieniem platformy, a nie gwarancją GenderAPI.
- Dodaj akcję Send any HTTP Request, wybierz POST i podaj poniższy adres URL. Skonfiguruj treść JSON z type = email, value = adres e-mail kontaktu i options.ai_mode = off.
- Zapisz klucz za pomocą kontrolek danych uwierzytelniających lub zmiennych środowiskowych Pipedream. Ustaw Authorization na Bearer, a po nim ten sekret, oraz Content-Type na application/json. Nie używaj ponownie natywnego uwierzytelniania kluczem w ciągu zapytania i nie wyświetlaj klucza w żadnym kroku.
- Zbuduj treść jako obiekt JSON za pomocą kontrolek mapowania obsługiwanych przez akcję. Nie składaj surowego JSON przez łączenie wartości kontaktu bez zmiany znaków specjalnych. Przed celowym uruchomieniem testu sprawdź podgląd 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 Pipedream**

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

Sprawdź odpowiedź eksportowaną przez krok HTTP i znajdź przeanalizowaną treść. Jeśli wybrana akcja zwraca treść jako tekst, przeanalizuj ją jeden raz przed odczytaniem data i meta. Pole data w opakowaniu transportowym jest czymś innym niż pole data w treści V2.

W przepływie pracy opartym na kodzie, z jawną kontrolą limitów czasu, przekierowań i ponownych prób, skorzystaj z przetestowanego przewodnika Node.js podanego poniżej. Ogólna akcja i aplikacja natywna mogą mieć różne domyślne ustawienia transportu.

- [Publiczny komponent GenderAPI.io w Pipedream](https://github.com/PipedreamHQ/pipedream/blob/master/components/genderapi_io/genderapi_io.app.mjs)
- [Akcje zapytań HTTP w Pipedream](https://pipedream.com/docs/workflows/building-workflows/http)
- [Tajne zmienne środowiskowe w Pipedream](https://pipedream.com/docs/workflows/environment-variables)
- [Ustawienia przepływu pracy i ponowne próby w Pipedream](https://pipedream.com/docs/workflows/building-workflows/settings)

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

Przechowuj identyfikator kontaktu zwrócony przez wyzwalacz razem z przeanalizowaną treścią V2. Po zastosowaniu kontroli wyników opisanych powyżej aktualizuj wyłącznie zaplanowane pola niestandardowe SendGrid. Zachowaj imię podane przez kontakt: data.name wywnioskowane z adresu e-mail jest kandydatem uzyskanym w drodze wnioskowania, a nie zweryfikowanym zamiennikiem.

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

Pipedream dokumentuje automatyczne ponowne próby od kroku, który zakończył się błędem, zależnie od planu. Sprawdź te ustawienia oraz sposób ponawiania w wybranej akcji HTTP. Ponowienie nieudanego kroku wzbogacania może spowodować kolejne obciążenie; późniejszy błąd w systemie docelowym należy naprawić na podstawie zapisanych danych wyjściowych wzbogacania.

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 natywna akcja GenderAPI.io w Pipedream korzysta z V2?

Publiczny komponent sprawdzony 26 września 2026 r. korzysta ze starszych endpointów V1 i uwierzytelniania kluczem w ciągu zapytania. Do zapytania V2 użyj jawnego przepisu HTTP V2 i ponownie sprawdź opublikowany komponent, jeśli zmieni się jego wersja.

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

- [Aplikacja GenderAPI.io w Pipedream](https://pipedream.com/apps/genderapi-io)
- [Publiczny komponent GenderAPI.io w Pipedream](https://github.com/PipedreamHQ/pipedream/blob/master/components/genderapi_io/genderapi_io.app.mjs)
- [Akcje zapytań HTTP w Pipedream](https://pipedream.com/docs/workflows/building-workflows/http)
- [Tajne zmienne środowiskowe w Pipedream](https://pipedream.com/docs/workflows/environment-variables)
- [Ustawienia przepływu pracy i ponowne próby w Pipedream](https://pipedream.com/docs/workflows/building-workflows/settings)
- [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)