Välj den Pabbly Connect-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.
Pabblys offentliga katalog innehåller en app som heter Gender API, men den granskade posten anger varken leverantörens domän, slutpunktens version eller det fullständiga svarsschemat. Namnet i sig visar inte att det gäller GenderAPI.io. Kontrollera leverantören och de faktiska fälten innan du väljer en inbyggd åtgärd.
För att använda en uttrycklig V2-slutpunkt använder du funktionen för anpassade API-förfrågningar i API by Pabbly. Det här receptet beskriver den HTTP-förfrågan; det påstår inte att den inbyggda kopplingen har ställts om till V2.
Förbered kontot och källposten
Det här exemplet berikar poster i Shopify utifrån förnamnet. 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.
Konfigurera GenderAPI.io V2-förfrågan i Pabbly Connect
- Välj en Shopify-utlösare som passar den kundhändelse du behöver och fånga en representativ testpost. Spara kundens id och mappa det tillgängliga fältet för förnamn. Hoppa över ett tomt förnamn i stället för att ersätta det med hela kundposten.
- Lägg till API by Pabbly och välj Custom Request. Välj POST och V2-URL:en nedan. Konfigurera autentisering med Bearer token och GenderAPI-nyckeln, eller en rubrik Authorization vars fullständiga värde är Bearer YOUR_API_KEY; konfigurera inte båda mekanismerna samtidigt.
- Sätt Content-Type till application/json. Custom Request har ett fält Data för JSON-kroppen. Skapa ett objekt med type = name, value = mappat förnamn och ett objekt options med ai_mode = off. Rubriken Content-Type beskriver den angivna kroppen; den omvandlar inte formulärfält till ett JSON-objekt av sig själv.
- Låt options vara kapslat. Om den valda åtgärden bara accepterar rå JSON ser du till att citattecken, omvända snedstreck och radbrytningar i mappade värden är korrekt JSON-kodade; använd ett stött steg för att skapa JSON i stället för att infoga okodad kundtext.
| 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.
{
"type": "name",
"value": "Alice",
"options": {
"ai_mode": "off"
}
}Kontrollera HTTP-steget innan du aktiverar uppdateringar
Granska den fångade svarskroppen och se till att nästa steg läser V2-kroppen och inte transportens statusfält. Pabbly kan göra svarsnycklar tillgängliga för senare mappning; kontrollera deras faktiska sökväg i ditt arbetsflöde.
Kör bara den valda teståtgärden under konfigurationen. Ett test som skickar en förfrågan kan förbruka GenderAPI-krediter och plattformsuppgifter redan innan arbetsflödet har aktiverats.
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. |
Uppdatera bara den matchande posten i Shopify
Spara det kund-id i Shopify som utlösaren levererar. Led bekräftade resultat identified till det avsedda kundfältet eller enligt policyn för taggar, behåll resultat unknown som unknown och ändra inte det förnamn som kunden har angett. Spara source och confidence_kind för varje godkänd prediktion.
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.
Kontrollera nya försök och upprepade debiteringar
Pabbly dokumenterar Auto Re-execution samt manuella alternativ för att köra om misslyckade eller överhoppade steg eller hela arbetsflödet. Kontrollera vad som körs innan du använder något av alternativen. Att köra om hela arbetsflödet kan upprepa en redan slutförd GenderAPI-förfrågan; reparera om möjligt ett senare fel i Shopify med det sparade svaret.
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.
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 |
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.
Vanliga frågor
Kan jag använda ett platt formulärfält options.ai_mode i Pabbly?
V2-kroppen för POST kräver ett JSON-objekt options. En punkt i fältets beteckning visar inte i sig att plattformen skapar ett kapslat objekt. Kontrollera den serialiserade kroppen innan du skickar förfrågan och se till att den motsvarar exemplet.
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
Den svenska versionen granskades senast . Informationen om plattformarna bygger på deras offentliga dokumentation, granskad 26 september 2026. Den granskningen är inget nytt test med ett anslutet konto. Kontrollera aktuell konfiguration och tillgänglighet i plattformarnas officiella dokumentation.