# Koble Zapier til GenderAPI.io V2

> Koble Zapier til GenderAPI.io V2 for poster i Mailchimp. Velg riktig kobling, send type og value, og håndter deretter data, meta, kreditter og feil.

Canonical HTML: https://www.genderapi.io/nb/blog/zapier-gender-api-integration

Last reviewed: 2026-09-29

## Velg den Zapier-koblingen som passer til API-kontrakten din

HTTP-oppsettet i denne veiledningen kaller GenderAPI.io V2 på https://api.genderapi.io/api/v2/gender. Send type og value i JSON-bodyen. Estimatet finner du i data, mens opplysningene om forespørselen og belastningen finner du i meta. Innebygde koblinger har egne kontrakter, som er beskrevet nedenfor.

Zapier har GenderAPI.io-handlinger for å finne kjønn ut fra et navn eller en e-postadresse. Den offentlige oppføringen fastslår verken versjonen av endepunktet eller en svarkontrakt for V2. Utdataet fra eksisterende innebygde handlinger må kontrolleres før du endrer tilordningene i senere steg.

V2-oppsettet nedenfor bruker Webhooks by Zapier med en strukturert POST-payload. Tilgang til Webhooks krever et betalt Zapier-abonnement. Saldoen på GenderAPI-kontoen og oppgavene Zapier selv bruker, er separate.

- [Den offisielle oppføringen av GenderAPI.io-appen på Zapier](https://zapier.com/apps/gender-api/integrations)
- [Eksisterende V1-dokumentasjon](https://www.genderapi.io/nb/api-documentation/v1)

## Klargjør kontoen og kildeposten

Dette eksemplet beriker poster i Mailchimp basert på e-postadressen. 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](https://www.genderapi.io/nb/docs/v2/authentication#environment-setup)

## Konfigurer GenderAPI.io V2-forespørselen i Zapier

- Start med den Mailchimp-utløseren som leverer riktig abonnentpost. Behold ID-ene for målgruppen (Audience) og kontakten, og legg til et filter før HTTP-handlingen som hopper over tomme e-postadresser.
- Velg Webhooks by Zapier og handlingen POST. Angi URL-en nedenfor og Payload Type: JSON. Legg til datafeltene type = email, value = abonnentens tilordnede e-postadresse og options__ai_mode = off.
- I Zapier nester notasjonen med dobbel understrek options__ai_mode som options.ai_mode i JSON-bodyen. Kodeblokken nedenfor viser bodyen som API-et mottar. Det er ikke et fjerde felt du skal lime inn i handlingen.
- Legg til Authorization med verdien Bearer YOUR_API_KEY under Headers. Bruk application/json som Content-Type. Hold nøkkelen utenfor feltene i utløseren, spørrestrenger og eksempeldata i svar.

| HTTP-innstilling | Verdi | Formål |
| --- | --- | --- |
| `Method` | `POST` | Sender én forespørsel om et estimat. |
| `URL` | `https://api.genderapi.io/api/v2/gender` | GenderAPI.io V2-endepunktet for enkeltestimater. |
| `Authorization` | `Bearer YOUR_API_KEY` | Erstatt plassholderen via plattformens innstillinger for autentisering eller headere. |
| `Content-Type` | `application/json` | Sender et objekt med et nestet options-objekt, ikke skjemafelter. |
| `options.ai_mode` | `off` | En bevisst første test med bare datasettet. Vanlig belastning er 1 kreditt, også når resultatet er ukjent. |

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

**V2-forespørsel i JSON for Zapier**

```json
{
  "type": "email",
  "value": "alex@example.com",
  "options": {
    "ai_mode": "off"
  }
}
```

- [Alle felt, typer og standardverdier i forespørselen](https://www.genderapi.io/nb/docs/v2/request-parameters)

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

Headerne i Webhooks er ikke et eget felt for hemmelige tilkoblinger: Alle som kan redigere Zap-en, kan se dem. Begrens tilgangen, og ikke del en Zap, et skjermbilde eller en eksport som inneholder påloggingsopplysningene. Zapier tilbyr også API by Zapier med lagrede påloggingsopplysninger, men der er oppsettet av forespørselens body annerledes enn i denne strukturerte POST-oppskriften.

Ikke pakk inn bodyen: Send ett objekt, ikke en liste eller et array. Velg den strukturerte JSON-handlingen for tilordnede kundedata. Custom Request sender rå tekst og escaper ikke automatisk verdier som settes inn.

- [Strukturerte Webhooks-forespørsler og nestet JSON i Zapier](https://help.zapier.com/hc/en-us/articles/8496326446989-Send-webhooks-in-Zap-workflows)
- [Tilkoblinger med påloggingsopplysninger i API by Zapier](https://help.zapier.com/hc/en-us/articles/44391660158733-How-to-get-started-with-API-by-Zapier)
- [Slik fungerer gjentakelse (Replay) i Zapier](https://help.zapier.com/hc/en-us/articles/19220226086797-What-is-replay)

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

| Kontroll | Forventet verdi eller type | Beslutning i arbeidsflyten |
| --- | --- | --- |
| `meta.access.mode` | api_key for denne arbeidsflyten med konto | Stopp arbeidsflyten hvis verdien er ip_trial, og rett nøkkelen. Et vellykket svar fra IP-prøveperioden beviser ikke at kontoen ble autentisert, og kan allerede ha brukt kreditter fra prøveperioden. |
| `meta.usage.billing_status` | confirmed eller unconfirmed | Hvis verdien er unconfirmed, beholder du forespørselens ID og får belastningen avstemt før du gjør et nytt forsøk eller fortsetter. |
| `data.result_status / data.gender` | identified med male eller female; unknown med null | Send aksepterte identified-resultater til et eget felt for utledede data. Bevar unknown-resultater uten å tildele en standardkategori. |
| `data.confidence / data.confidence_kind` | tall fra 0 til 1 eller null; evidenstype eller null | Tolk observed_frequency og model_reported hver for seg. Ingen av dem er en generell garanti for nøyaktighet. |
| `data.source / data.sample_count` | dataset, ai eller none / heltall eller null | Lagre hvordan estimatet ble innhentet. KI har ikke noe lagret utvalgsantall, og et antall fra datasettet er ikke et mål på produktets nøyaktighet. |
| `meta.request_id / meta.usage` | forespørselens referanse / forbruksobjekt | Lagre begge sammen med posten og resultatet i arbeidsflyten. Hold API-nøkler og unødvendige personopplysninger utenfor vanlige logger. |
| `HTTP-feil / manglende svar` | Problem Details eller ikke noe fullstendig svar | Sett oppdateringen på pause, og kontroller feilen og belastningsstatusen. Et tidsavbrudd beviser ikke at serveren ikke har utført noe arbeid. |

- [Fullstendig referanse for V2-svaret](https://www.genderapi.io/nb/docs/v2/responses)
- [Beslutninger ved feil, tidsavbrudd og nye forsøk](https://www.genderapi.io/nb/docs/v2/errors-and-retries)

## Oppdater bare den tilsvarende posten i Mailchimp

Gå gjennom det tolkede svaret fra testhandlingen, og velg feltene som tilsvarer data.gender, data.result_status og de andre V2-stiene nedenfor. Feltvelgeren i Zapier kan gjøre nestede feltetiketter flate: Ta utgangspunkt i den observerte verdien og den overordnede stien i stedet for å anta at den innebygde koblingens eldre felt probability gjelder.

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](https://www.genderapi.io/nb/docs/v2/responses)
- [Nøyaktighet og konfidens forklart](https://www.genderapi.io/nb/accuracy-methodology)
- [Datakilder og den daterte profilen til datasettet](https://www.genderapi.io/nb/data-provenance)

## Kontroller nye forsøk og gjentatte belastninger

Gå gjennom innstillingene for Autoreplay og manuell gjentakelse (Replay) i Zapier før du slår på Zap-en. Når du gjentar en mislykket webhook-handling, sendes en ny forespørsel. En vellykket forespørsel bør ikke kjøres på nytt bare for å rette et senere Mailchimp-steg. Lagre abonnentens opprinnelige ID-er og resultatet av forespørselen sammen.

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](https://www.genderapi.io/nb/docs/v2/credits-and-usage)

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

| Alternativ i forespørselen | Virkemåte | Kreditter for et vellykket oppslag |
| --- | --- | --- |
| options.ai_mode: off | Bruker bare datasettet. | 1, også for et ukjent resultat |
| options.ai_mode: fallback | Søker først i datasettet og bruker deretter vanlig KI hvis det ikke returneres et kjønn. Dette er standard for enkeltforespørsler. | 1 totalt, inkludert KI-reserve |
| options.ai_mode: always | Bruker KI direkte. | 2 |
| forceToGenderize: true | Søker først i datasettet og lar deretter KI tolke et personlig kallenavn eller alias, selv uten et ekte fornavn. | 1 for et resultat fra datasettet; 2 totalt hvis KI brukes |

- [KI-alternativer og tolkning av kallenavn](https://www.genderapi.io/nb/docs/v2/ai-options)
- [Kreditter og forbruk](https://www.genderapi.io/nb/docs/v2/credits-and-usage)

## 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](https://www.genderapi.io/nb/docs/v2/batch)
- [Implementeringsguide for Python](https://www.genderapi.io/nb/integrations/python)
- [Implementeringsguide for Node.js](https://www.genderapi.io/nb/integrations/javascript)

## Hvorfor bruker oppsettet i Zapier options__ai_mode?

Den strukturerte POST-handlingen i Webhooks bruker dobbel understrek for å lage nestet JSON. API-et mottar options: {ai_mode: off}, der off er en streng. Det mottar ikke et bokstavelig felt options__ai_mode på øverste nivå.

## Bruker det direkte HTTP-eksemplet KI?

Bodyen i den første forespørselen setter options.ai_mode til off. Endre verdien bevisst til fallback for å bruke vanlig KI-reserve for en samlet belastning på 1 kreditt, eller til always for å bruke KI direkte for 2 kreditter. forceToGenderize slår først opp i datasettet og koster 1 kreditt hvis forespørselen avgjøres der, eller 2 totalt når KI brukes.

## Er et unknown-resultat gratis, og kan det trygt gjentas automatisk?

Nei. Et vellykket unknown-resultat er fullstendig og belastes. Et nytt forsøk er en ny operasjon. Ved transportfeil eller belastning som ikke er bekreftet, bør du kontrollere de returnerte forbruksdataene og forespørselens referanse før du bestemmer om den skal sendes på nytt.

## Er denne arbeidsflyten kjørt med en tilkoblet konto?

Nei. Plattformenes oppsettsveiledninger ble gjennomgått mot offentlig dokumentasjon 26. september 2026. Forklaringene av forespørselen og svaret i GenderAPI.io V2 ble gjennomgått 27. september 2026. Gjennomgangen av denne norske versjonen 29. september 2026 er en kontroll av oversettelsen og ikke en ny test med en konto. Før du aktiverer oppdateringer i produksjon, må du teste de gjeldende feltene i den valgte handlingen, autentiseringen, bodyen, svaret og de nye forsøkene med din egen konto.

## Kilder og dokumentasjon

- [Den offisielle oppføringen av GenderAPI.io-appen på Zapier](https://zapier.com/apps/gender-api/integrations)
- [Strukturerte Webhooks-forespørsler og nestet JSON i Zapier](https://help.zapier.com/hc/en-us/articles/8496326446989-Send-webhooks-in-Zap-workflows)
- [Tilkoblinger med påloggingsopplysninger i API by Zapier](https://help.zapier.com/hc/en-us/articles/44391660158733-How-to-get-started-with-API-by-Zapier)
- [Slik fungerer gjentakelse (Replay) i Zapier](https://help.zapier.com/hc/en-us/articles/19220226086797-What-is-replay)
- [Forespørselskontrakten i GenderAPI.io V2](https://www.genderapi.io/nb/docs/v2/request-parameters)
- [Svarkontrakten i GenderAPI.io V2](https://www.genderapi.io/nb/docs/v2/responses)
- [Belastning og kreditter i GenderAPI.io V2](https://www.genderapi.io/nb/docs/v2/credits-and-usage)