Koble Pabbly Connect til GenderAPI.io V2

Klargjør kontoen og kildeposten

Dette eksemplet beriker poster i Shopify basert på navnet. Du trenger tilgang til kildeappen og målappen, en kontonøkkel for GenderAPI.io og plattformfunksjonene som HTTP-handlingen bruker. Veiledningen inneholder verken fungerende påloggingsopplysninger eller tilkoblede kontoer.

V1 og V2 bruker den samme kontonøkkelen og den samme saldoen. Før du setter opp en forespørsel som belastes, bør du kontrollere nøkkelen med GET /api/v2/usage og sjekke at meta.access.mode har verdien api_key i svaret fra dette endepunktet. En manglende eller ukjent nøkkel kan falle tilbake til den delte IP-prøveperioden. En automatisering i produksjon bør ikke drives av dette uten at du vet om det.

La arbeidsflyten være deaktivert mens du konfigurerer den. En testprediksjon bruker vanlige kreditter. Veiledningen er gjennomgått mot offentlig dokumentasjon og V2-kontrakten. Det er ikke kjørt noen autentisert arbeidsflyt fra start til slutt på noen plattform i forbindelse med denne publiseringen.

• Autentisering og gratis kontroll av forbruket →

Konfigurer GenderAPI.io V2-forespørselen i Pabbly Connect

• Velg den Shopify-utløseren som passer til kundehendelsen du trenger, og hent én representativ testpost. Behold kundens ID, og tilordne et tilgjengelig felt for fornavn (first name). Hopp over et tomt navn i stedet for å erstatte det med hele kundeposten.
• Legg til API by Pabbly, og velg Custom Request. Velg POST og V2-URL-en nedenfor. Konfigurer autentisering med Bearer token og GenderAPI-nøkkelen din, eller med en Authorization-header der hele verdien er Bearer YOUR_API_KEY. Ikke konfigurer begge mekanismene.
• Sett Content-Type til application/json. Custom Request har et "Data"-felt for JSON-bodyen. Lag et objekt med type = name, et options-objekt med ai_mode = off og value = det tilordnede fornavnet. Headeren Content-Type beskriver bare formatet på den oppgitte bodyen og gjør ikke skjemafelt om til et JSON-objekt.
• Behold options som et nestet objekt. Hvis den valgte handlingen bare tilbyr rå JSON, må du sørge for at anførselstegn, omvendte skråstreker og linjeskift i tilordnede verdier er korrekt escapet som JSON. Bruk et støttet steg for å bygge JSON i stedet for å sette inn kundetekst som ikke er escapet.

Kontroller JSON-bodyen før du sender den

Eksemplet viser en fast inndata, ikke et forventet resultat. Kontroller først strukturen på forespørselen, og erstatt deretter value med det tilordnede kildefeltet ved hjelp av korrekt JSON-serialisering. Ikke lim inn plattformens tilordningsuttrykk i API-et som bokstavelig tekst.

For andre inndata setter du type til name, email eller username og oppgir den tilsvarende verdien i value. Legg bare til country når du har pålitelig kontekst. Feltet er valgfritt og brukes ikke til å slå opp hvilket land en person bor i.

{
  "type": "name",
  "value": "Alice",
  "options": {
    "ai_mode": "off"
  }
}

• Alle felt, typer og standardverdier i forespørselen →

Kontroller HTTP-steget før du slår på oppdateringer

Gå gjennom den hentede bodyen i svaret, og sørg for at neste steg leser V2-bodyen og ikke statusfeltene fra transporten. Pabbly kan gjøre nøklene i svaret tilgjengelige for senere tilordning. Kontroller den faktiske stien deres i arbeidsflyten din.

Kjør bare den valgte testhandlingen mens du konfigurerer flyten. En test som sender forespørselen, kan bruke GenderAPI-kreditter og oppgaver i plattformen allerede før arbeidsflyten er aktivert.

• Kundestøtte hos Pabbly: Custom Request og JSON-feltet "Data" →
• Oppføring i Pabblys offentlige katalog (utgiver ikke bekreftet) →

Håndter identified, unknown og feil hver for seg

Tolk svarets body før du velger en oppdatering i målsystemet. JSON-stiene nedenfor viser til bodyen i V2-svaret. Plattformen din kan pakke den inn eller gjøre den flat. Bekreft strukturen som faktisk returneres, med en bevisst test, og hold resultatet knyttet til kildepostens ID.

Et estimat fastslår verken en persons identitet eller kjønn som personen selv har oppgitt. Lagre det atskilt fra opplysninger personen selv har gitt. Velg akseptkriterier ut fra data som er representative for ditt eget bruksområde, og vurder konfidens fra datasettet og konfidens fra KI hver for seg.

• Fullstendig referanse for V2-svaret →
• Beslutninger ved feil, tidsavbrudd og nye forsøk →

Oppdater bare den tilsvarende posten i Shopify

Behold Shopify-kundens ID fra utløseren. Send bekreftede identified-resultater til det planlagte kundefeltet eller etter policyen for tagger, behold unknown-resultater som unknown, og la navnet kunden selv har oppgitt, være uendret. Lagre source og confidence_kind sammen med hvert estimat som aksepteres.

Test grenene for et identified-resultat, et ukjent resultat og en feil før du slår på oppdateringer. Med fiktive eksempelsvar kan du kontrollere betingelsene for grenene uten å sende en ny forespørsel om et estimat. Oppdateringen i målappen skal avhenge av kontrollene ovenfor og skal ikke overskrive felter eller tagger som ikke er relevante.

• Svarfelt og ukjente resultater →
• Nøyaktighet og konfidens forklart →
• Datakilder og den daterte profilen til datasettet →

Kontroller nye forsøk og gjentatte belastninger

Pabbly dokumenterer Auto Re-execution og manuelle valg for å kjøre mislykkede eller hoppede steg eller hele arbeidsflyten på nytt. Gå gjennom hva som vil bli kjørt, før du bruker et av disse valgene. Hvis du kjører hele arbeidsflyten på nytt, kan en fullført GenderAPI-forespørsel bli gjentatt. Rett om mulig en senere feil i Shopify ut fra det lagrede svaret.

Hver nye forespørsel til GenderAPI er en selvstendig operasjon. Fjern gjentatte kildehendelser i arbeidsflyten din før sending ved hjelp av en lagret kilde-ID og behandlingsstatus. ID-en til kildeposten er ikke en nøkkel som beskytter mot gjentakelser på serversiden.

Et vellykket ukjent resultat er et fullført resultat som belastes. Ved tidsavbrudd eller et ufullstendig svar kan både resultatet og belastningen være ukjent. Behold referansen til forespørselen når den finnes, og avstem belastningen før du sender forespørselen på nytt. Følg headeren Retry-After når den finnes i svar om hastighetsgrense.

• Kreditter og belastningsstatus →

Bestem når KI skal brukes

forceToGenderize er valgfritt for navn, e-postadresser og brukernavn. Når det er aktivert, utelater du ai_mode eller bruker fallback; off og always kan ikke kombineres med dette alternativet og gir 422. En positiv startsaldo er nok til å starte en forespørsel, selv om den endelige belastningen gjør saldoen negativ.

Kallenavnmodus kan returnere et kjønn sammen med name: null. Den kan også gi et ukjent resultat. Verken vanlig KI-reserve eller tolkning av kallenavn garanterer et riktig svar eller en verdi som ikke er null.

• KI-alternativer og tolkning av kallenavn →
• Kreditter og forbruk →

Kontroller arbeidsflyten før du øker volumet

• Kontroller den faktisk serialiserte JSON-en, de tolkede resultatstiene, tilgangen med API-nøkkel og bekreftet belastning med en bevisst test. Test håndteringen av unknown-resultater og feil med eksempelsvar der det er mulig.
• Avklar hvilke steg i arbeidsflyten som gjør nye forsøk, og hvilke kundefelt som endres. Behold kildepostens ID, det fullførte svaret og forespørselens referanse, slik at en senere feil i målsystemet ikke krever en ny forespørsel.
• Aktiver først en liten, kontrollert kjøring, og kontroller postene og kredittene før du øker parallelliteten. Kreditter i GenderAPI og oppgavene eller operasjonene som automatiseringsplattformen belaster, er separate kostnader.
• For samleforespørsler bruker du POST /api/v2/gender/batch med opptil 50 elementer ved tilgang med API-nøkkel eller 10 i IP-prøveperioden. Arrayet items kan blande navn, e-postadresser og brukernavn, med eksplisitte innstillinger og en unik ID for hvert element. Kontroller hvert resultat: Et HTTP 200-svar kan inneholde feil for enkeltelementer. Om en innebygd kobling støtter samleforespørsler, må kontrolleres separat.

• Samleforespørsler og feil for enkeltelementer →
• Implementeringsguide for Python →
• Implementeringsguide for Node.js →

Ofte stilte spørsmål