# Anslut Make till GenderAPI.io V2

> Anslut Make till GenderAPI.io V2 för poster i Shopify. Välj rätt koppling, skicka type och value och hantera sedan data, meta, krediter och fel.

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

Last reviewed: 2026-09-28

## Välj den Make-anslutning som passar ditt API-kontrakt

HTTP-receptet i den här guiden anropar GenderAPI.io V2 på https://api.genderapi.io/api/v2/gender. Skicka type och value i JSON-kroppen; prediktionen läser du i data och uppgifterna om förfrågan och debiteringen i meta. Inbyggda kopplingar har egna kontrakt, som beskrivs nedan.

Make erbjuder en GenderAPI.io-app med åtgärder för namn och e-postadresser. Den offentliga sidan hänvisar till genderapi.io men anger varken slutpunktens exakta version eller det fullständiga svarsschemat. Innan du ändrar mappningen i befintliga scenarier kontrollerar du den faktiska utdatan från den valda modulen.

För ett uttryckligt V2-beteende använder du HTTP-appen i Make med förfrågan nedan. Den här HTTP-konfigurationen uppdaterar ingen befintlig GenderAPI-modul: låt pågående scenarier fortsätta separat tills deras ersättning har kontrollerats.

- [GenderAPI.io-appen hos Make](https://www.make.com/en/integrations/gender-api)
- [Befintlig V1-dokumentation](https://www.genderapi.io/sv/api-documentation/v1)

## Förbered kontot och källposten

Det här exemplet berikar poster i Shopify utifrån e-postadressen. Du behöver åtkomst till käll- och målapplikationen, en kontonyckel för GenderAPI.io och de plattformsfunktioner som HTTP-åtgärden använder. Den här guiden innehåller inga fungerande inloggningsuppgifter och inga anslutna konton.

V1 och V2 använder samma kontonyckel och samma saldo. Innan du konfigurerar en förfrågan som debiteras kontrollerar du nyckeln med GET /api/v2/usage och ser till att meta.access.mode i svaret från den slutpunkten har värdet api_key. En nyckel som saknas eller inte känns igen kan leda till att den delade IP-provperioden används; en automatisering i produktion bör inte använda den obemärkt.

Håll arbetsflödet inaktiverat medan du konfigurerar det. En testprediktion förbrukar vanliga krediter. De här guiderna har granskats mot den offentliga dokumentationen och V2-kontraktet; inget autentiserat arbetsflöde har körts från början till slut på någon plattform för den här publiceringen.

- [Autentisering och kostnadsfri kontroll av användningen](https://www.genderapi.io/sv/docs/v2/authentication#environment-setup)

## Konfigurera GenderAPI.io V2-förfrågan i Make

- Välj en Shopify-utlösare för kunder som passar ditt scenario och läs in en representativ testpost. Spara kundens id för den avslutande uppdateringen och hoppa över poster med tom e-postadress.
- Lägg till HTTP > Make a request. Välj autentiseringen API key i den aktuella HTTP-appen och skapa inloggningsuppgifter med nyckelvärdet Bearer YOUR_API_KEY, placeringen Header och parameternamnet Authorization. Använd den här hanteringen av inloggningsuppgifter i stället för att skriva nyckeln i URL:en.
- Ställ in metoden på POST och URL:en nedan. Välj application/json för förfrågans kropp och en datastruktur med textfälten type och value och en samling options med textfältet ai_mode. Sätt type till email och ai_mode till off och mappa sedan kundens e-postadress till value.
- Aktivera Parse response. En kropp som skapas med en datastruktur i Make serialiserar de mappade värdena som JSON, så att namn eller adresser med citattecken inte kräver manuell textsammanfogning.

| HTTP-inställning | Värde | Syfte |
| --- | --- | --- |
| `Method` | `POST` | Skickar en enskild prediktionsförfrågan. |
| `URL` | `https://api.genderapi.io/api/v2/gender` | GenderAPI.io:s V2-slutpunkt för enskilda prediktioner. |
| `Authorization` | `Bearer YOUR_API_KEY` | Ersätt platshållaren via plattformens inställningar för autentisering eller rubriker. |
| `Content-Type` | `application/json` | Skickar ett objekt med ett kapslat options-objekt, inga formulärfält. |
| `options.ai_mode` | `off` | Första medvetna test med bara datamängden: normal debitering av 1 kredit, även om resultatet är unknown. |

## Kontrollera JSON-kroppen innan du skickar

Det här exemplet visar fasta indata; det är inget förutsagt resultat. Kontrollera först förfrågans struktur och ersätt sedan value med det mappade källfältet, med korrekt JSON-serialisering. Skicka inte plattformens mappningsuttryck som bokstavlig text till API:et.

För andra indata sätter du type till name, email eller username och anger motsvarande värde i value. Lägg bara till country när du har tillförlitlig kontext: fältet är valfritt och är inte avsett att fastställa bosättningsland.

**V2-JSON-förfrågan för Make**

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

- [Fält, typer och standardvärden i förfrågan](https://www.genderapi.io/sv/docs/v2/request-parameters)

## Kontrollera HTTP-steget innan du aktiverar uppdateringar

Låt omdirigeringar vara inaktiverade för det här fasta HTTPS-målet för API:et. Om du byter version av HTTP-appen i Make kontrollerar du inställningarna för autentisering och förfrågans kropp igen: reglagen kan skilja sig åt.

Kör ett avgränsat test, granska det tolkade svarspaketet (bundle) och skapa separata vägar för godkända resultat identified, resultat unknown och driftfel innan du lägger till kunduppdateringen.

- [Konfiguration av HTTP-appen i Make](https://apps.make.com/http)
- [Inloggningsuppgifter API key och placeringen Header i Make](https://apps.make.com/api-key-authentication-type)
- [Automatiska nya försök för ofullständiga körningar i Make](https://help.make.com/automatic-retry-of-incomplete-executions)

## Hantera resultaten identified, unknown och fel separat

Tolka svarskroppen innan du väljer en uppdatering i målsystemet. JSON-sökvägarna nedan avser V2-svarskroppen; din plattform kan kapsla in eller platta ut den. Bekräfta den struktur som faktiskt returneras i ett avgränsat test och spara resultatet tillsammans med källpostens id.

En prediktion fastställer varken en persons identitet eller det kön som personen själv uppger. Förvara den separat från uppgifter som personen själv har lämnat. Fastställ godkännandekriterier utifrån representativa data från ditt eget användningsfall och utvärdera konfidensen från datamängden och AI-konfidensen separat.

| Kontroll | Förväntat värde eller typ | Beslut i arbetsflödet |
| --- | --- | --- |
| `meta.access.mode` | api_key för det här kontoarbetsflödet | Stoppa arbetsflödet om värdet är ip_trial och rätta nyckeln. Ett lyckat svar i IP-provperioden visar inte att kontot har autentiserats och kan redan ha förbrukat krediter från provperioden. |
| `meta.usage.billing_status` | confirmed eller unconfirmed | Om värdet är unconfirmed sparar du förfrågans id och klarlägger debiteringen innan du försöker igen eller fortsätter. |
| `data.result_status / data.gender` | identified med male eller female; unknown med null | Spara godkända resultat identified i ett eget fält för härledda uppgifter. Behåll resultat unknown utan att tilldela en standardkategori. |
| `data.confidence / data.confidence_kind` | Tal från 0–1 eller null; typ av underlag eller null | Tolka observed_frequency och model_reported separat; inget av värdena garanterar en generell noggrannhet. |
| `data.source / data.sample_count` | dataset, ai eller none / heltal eller null | Spara prediktionens ursprung. AI har ingen lagrad urvalsstorlek; en urvalsstorlek från datamängden är inget mått på produktens noggrannhet. |
| `meta.request_id / meta.usage` | Förfrågans referens / användningsobjekt | Spara båda tillsammans med arbetsflödets post och resultatet. Skriv inte API-nycklar eller onödiga personuppgifter till vanliga loggar. |
| `HTTP-fel / inget svar` | Problem Details eller inget fullständigt svar | Stoppa uppdateringen och granska felet och debiteringsstatusen. En överskriden tidsgräns visar inte att servern inte har bearbetat något. |

- [Fullständig dokumentation av V2-svaret](https://www.genderapi.io/sv/docs/v2/responses)
- [Fel, överskridna tidsgränser och beslut om nya försök](https://www.genderapi.io/sv/docs/v2/errors-and-retries)

## Uppdatera bara den matchande posten i Shopify

Mappa V2-kroppens sökvägar ovan i det tolkade HTTP-svaret. Make kan placera kroppen under en utdatabeteckning för modulen: välj de kapslade objekten data och meta från det granskade paketet. Uppdatera bara den kund vars id utlösaren har sparat, i ett eget fält för härledda uppgifter eller enligt en fastställd policy för taggar.

Testa grenarna för ett resultat identified, ett resultat unknown och ett fel innan du aktiverar uppdateringar. Med fiktiva exempelsvar kan du kontrollera villkoren för förgreningen utan att skicka en ny prediktion. Uppdateringen i målapplikationen bör bero på kontrollerna ovan och får inte skriva över orelaterade fält eller taggar.

- [Svarsfält och okända resultat](https://www.genderapi.io/sv/docs/v2/responses)
- [Noggrannhet och konfidens förklarade](https://www.genderapi.io/sv/accuracy-methodology)
- [Datakällor och den daterade databasprofilen](https://www.genderapi.io/sv/data-provenance)

## Kontrollera nya försök och upprepade debiteringar

Granska felhanterarna i Make och inställningarna för ofullständiga körningar. Vissa tillfälliga fel kan upprepas även utan uttrycklig hantering av nya försök. Ett nytt försök i HTTP-modulen kan skicka ytterligare en förfrågan som debiteras. Om förfrågan lyckades men den senare uppdateringen i Shopify inte gjorde det använder du den sparade utdatan för att reparera den uppdateringen.

Varje ny förfrågan till GenderAPI är en egen åtgärd. Deduplicera upprepade källhändelser i ditt eget arbetsflöde innan de skickas, med hjälp av det sparade käll-id:t och bearbetningsstatusen. Källpostens id är ingen nyckel som skyddar mot upprepningar på serversidan.

Ett lyckat resultat unknown är ett fullständigt resultat som debiteras. Vid en överskriden tidsgräns eller ett ofullständigt svar kan resultatet och debiteringen vara okända: spara förfrågans referens om den finns och klarlägg debiteringen innan du skickar förfrågan igen. Respektera rubriken Retry-After när den följer med ett svar om överskriden gräns för förfrågningar.

- [Krediter och debiteringsstatus](https://www.genderapi.io/sv/docs/v2/credits-and-usage)

## Bestäm när AI ska användas

forceToGenderize är valfritt för namn, e-postadresser och användarnamn. När det är aktiverat utelämnar du ai_mode eller använder fallback; off och always kan inte kombineras med det och ger 422. Ett positivt startsaldo räcker för att starta en förfrågan, även om den slutliga debiteringen gör saldot negativt.

Smeknamnsläget kan returnera ett kön tillsammans med name: null. Det kan också ge ett okänt resultat. Varken vanlig AI-reserv eller tolkning av smeknamn garanterar ett korrekt svar eller ett värde som inte är null.

| Alternativ i förfrågan | Beteende | Krediter för en lyckad sökning |
| --- | --- | --- |
| options.ai_mode: off | Använd bara datamängden. | 1, även för ett okänt resultat |
| options.ai_mode: fallback | Kontrollera datamängden först och använd sedan vanlig AI om inget kön returneras. Detta är standard för enskilda förfrågningar. | Totalt 1, inklusive AI-reserv |
| options.ai_mode: always | Använd AI direkt. | 2 |
| forceToGenderize: true | Kontrollera datamängden först och låt sedan AI tolka ett personligt smeknamn eller alias, även utan ett riktigt förnamn. | 1 för ett resultat som fastställs i datamängden; totalt 2 om AI används |

- [AI-alternativ och tolkning av smeknamn](https://www.genderapi.io/sv/docs/v2/ai-options)
- [Krediter och användning](https://www.genderapi.io/sv/docs/v2/credits-and-usage)

## Granska arbetsflödet innan du ökar volymen

- Kontrollera i ett avgränsat test den JSON som faktiskt serialiseras, de tolkade resultatsökvägarna, åtkomsten med API-nyckel och bekräftelsen av debiteringen. Testa om möjligt hanteringen av resultat unknown och av fel med exempelsvar.
- Klarlägg vilka steg i arbetsflödet som upprepas och vilka kundfält som ändras. Spara källpostens id, det mottagna svaret och förfrågans referens, så att ett senare fel i målsystemet inte kräver ytterligare en förfrågan.
- Aktivera först en liten, kontrollerad körning och granska dess poster och krediter innan du ökar parallelliteten. GenderAPI-krediter och de uppgifter eller operationer som automatiseringsplattformen debiterar är separata kostnader.
- För batchar använder du POST /api/v2/gender/batch med upp till 50 poster vid åtkomst med API-nyckel eller 10 med IP-provperioden. Arrayen items kan kombinera namn, e-postadresser och användarnamn, med uttryckliga alternativ och ett unikt id för varje post. Granska varje resultat: ett svar med HTTP 200 kan innehålla fel i enskilda poster. Batchstödet i en inbyggd koppling måste kontrolleras separat.

- [Batchar och fel i enskilda poster](https://www.genderapi.io/sv/docs/v2/batch)
- [Implementeringsguide för Python](https://www.genderapi.io/sv/integrations/python)
- [Implementeringsguide för Node.js](https://www.genderapi.io/sv/integrations/javascript)

## Ska jag lägga API-nyckeln i URL:en i Make?

Nej. Spara Bearer YOUR_API_KEY i HTTP-konfigurationen för V2 i inloggningsuppgifter av typen API key, med placeringen Header och Authorization som parameternamn. POST-slutpunkten accepterar ingen frågeparameter key.

## Tillåter det direkta HTTP-exemplet att AI används?

Kroppen i den första förfrågan sätter options.ai_mode till off. Ändra värdet medvetet till fallback för att använda den vanliga AI-reserven för totalt 1 kredit, eller till always för att använda AI direkt för 2 krediter. forceToGenderize kontrollerar datamängden först: det kostar 1 kredit om förfrågan fastställs där, eller totalt 2 om AI används.

## Är ett resultat unknown kostnadsfritt och kan det upprepas automatiskt utan risk?

Nej. Ett lyckat resultat unknown är fullständigt och debiteras. Ett nytt försök är en ny sökning. Vid ett transportfel eller en obekräftad debitering granskar du de returnerade användningsuppgifterna och förfrågans referens innan du bestämmer dig för att skicka förfrågan igen.

## Har det här arbetsflödet körts med ett anslutet konto?

Nej. Plattformarnas konfigurationsanvisningar granskades den 26 september 2026 mot deras offentliga dokumentation. Förklaringarna av förfrågan och svaret i GenderAPI.io V2 granskades den 27 september 2026. Revideringen av den här svenska versionen den 28 september 2026 är en granskning av översättningen och inget nytt test med ett konto. Innan du aktiverar uppdateringar i produktion testar du med ditt eget konto den valda åtgärdens aktuella fält, autentiseringen, förfrågans kropp, svaret och de nya försöken.

## Referensdokumentation

- [GenderAPI.io-appen hos Make](https://www.make.com/en/integrations/gender-api)
- [Konfiguration av HTTP-appen i Make](https://apps.make.com/http)
- [Inloggningsuppgifter API key och placeringen Header i Make](https://apps.make.com/api-key-authentication-type)
- [Automatiska nya försök för ofullständiga körningar i Make](https://help.make.com/automatic-retry-of-incomplete-executions)
- [Förfrågningskontrakt för GenderAPI.io V2](https://www.genderapi.io/sv/docs/v2/request-parameters)
- [Svarskontrakt för GenderAPI.io V2](https://www.genderapi.io/sv/docs/v2/responses)
- [Debitering och krediter i GenderAPI.io V2](https://www.genderapi.io/sv/docs/v2/credits-and-usage)