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.
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.
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.
{
"type": "name",
"value": "Alice",
"options": {
"ai_mode": "off"
}
}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.
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ł. |
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.
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ń.
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 |
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.
Najczęstsze pytania
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
Ostatnia weryfikacja polskiej wersji: . Wskazówki dotyczące platform opierają się na ich publicznej dokumentacji sprawdzonej 26 września 2026 r.; ta weryfikacja nie jest nowym testem na połączonym koncie. Aktualną konfigurację i dostępność sprawdź w oficjalnej dokumentacji platform.