# Koble Make til GenderAPI.io V2

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

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

Last reviewed: 2026-09-29

## Velg den Make-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.

Make har en GenderAPI.io-app med handlinger for navn og e-post. Den offentlige oppføringen lenker til genderapi.io, men oppgir verken den fullstendige versjonen av endepunktet eller svarets skjema. Kontroller det faktiske utdataet fra den valgte modulen før du tilordner felt i eksisterende scenarier.

For eksplisitt V2-atferd bruker du HTTP-appen i Make med forespørselen nedenfor. HTTP-oppsettet oppgraderer ikke en eksisterende GenderAPI-modul. Hold scenarier som fungerer, atskilt til erstatningen er kontrollert.

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

## Klargjør kontoen og kildeposten

Dette eksemplet beriker poster i Shopify 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 Make

- Velg den Shopify-utløseren for kunder som passer til scenariet ditt, og last inn en representativ testpost. Behold kundens ID til den endelige oppdateringen, og hopp over poster med tom e-post.
- Legg til HTTP > Make a request. I den gjeldende HTTP-appen velger du autentisering med API key og oppretter påloggingsopplysninger med nøkkelverdien Bearer YOUR_API_KEY, plasseringen Header og parameternavnet Authorization. Bruk lagringen for påloggingsopplysninger i stedet for å legge nøkkelen i en URL.
- Sett metoden til POST og URL-en som vises nedenfor. Velg application/json for forespørselens body og en datastruktur med tekstfeltene type og value og en options-samling med tekstfeltet ai_mode. Sett type til email og ai_mode til off, og tilordne kundens e-post til value.
- Slå på Parse response. En body som er bygd med en datastruktur i Make, serialiserer tilordnede verdier som JSON, slik at navn eller adresser med anførselstegn ikke krever at du setter sammen tekst for hånd.

| 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 Make**

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

La omdirigeringer være deaktivert for denne faste HTTPS-destinasjonen i API-et. Hvis du bytter mellom versjoner av HTTP-appen i Make, må du gå gjennom innstillingene for autentisering og body på nytt, fordi kontrollene kan være forskjellige.

Kjør én bevisst test, gå gjennom bunten (bundle) med det tolkede svaret, og opprett separate ruter for aksepterte identified-resultater, unknown-resultater og driftsfeil før du legger til oppdateringen av kunden.

- [Oppsett av HTTP-appen i Make](https://apps.make.com/http)
- [Påloggingsopplysninger med API key og plassering i header i Make](https://apps.make.com/api-key-authentication-type)
- [Automatiske nye forsøk for ufullstendige kjøringer i Make](https://help.make.com/automatic-retry-of-incomplete-executions)

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

Tilordne V2-stiene for bodyen nedenfor i det tolkede HTTP-svaret. Make kan plassere bodyen under en utdataetikett for modulen: Velg de nestede objektene data og meta fra bunten du har gått gjennom. Oppdater bare kunden med den ID-en som utløseren lagret, i et eget felt for utledede data eller etter en fastsatt policy for tagger.

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 feilhåndtererne i Make og innstillingene for ufullstendige kjøringer. Enkelte midlertidige feil kan gjentas selv uten en eksplisitt Retry-håndterer. Et nytt forsøk i HTTP-modulen kan sende en ny forespørsel som belastes. Hvis forespørselen lyktes, men en senere oppdatering i Shopify mislyktes, bruker du det lagrede utdataet fra forespørselen når du retter den oppdateringen.

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)

## Bør jeg lime inn API-nøkkelen i URL-en i Make?

Nei. I HTTP-oppsettet for V2 lagrer du Bearer YOUR_API_KEY i påloggingsopplysninger av typen API key, med plasseringen Header og Authorization som parameternavn. POST-endepunktet godtar ikke en key-parameter i spørrestrengen.

## 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å Make](https://www.make.com/en/integrations/gender-api)
- [Oppsett av HTTP-appen i Make](https://apps.make.com/http)
- [Påloggingsopplysninger med API key og plassering i header i Make](https://apps.make.com/api-key-authentication-type)
- [Automatiske nye forsøk for ufullstendige kjøringer i Make](https://help.make.com/automatic-retry-of-incomplete-executions)
- [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)