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.
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.
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.
{
"type": "name",
"value": "Alice",
"options": {
"ai_mode": "off"
}
}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.
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 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.
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ń.
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 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
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.