Anslut Pipedream till GenderAPI.io V2

Välj den Pipedream-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.

Pipedreams offentliga GenderAPI.io-komponent, granskad den 26 september 2026, använder den äldre basen https://api.genderapi.io/api och skickar name eller email, valfritt country samt API-nyckeln som frågeparametrar. Den publicerade implementeringen är en V1-koppling och ingen V2-JSON-slutpunkt.

Du kan behålla den befintliga inbyggda åtgärden med dess eget kontrakt eller lägga till ett allmänt HTTP-steg för V2. Förutsätt inte att den automatiska autentiseringen för det inbyggt anslutna kontot passar den här separata V2-förfrågan: receptet använder uttryckligen en Bearer-rubrik.

Förbered kontot och källposten

Det här exemplet berikar poster i Twilio SendGrid 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

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

Välj en Twilio SendGrid-händelse eller ett schema som passar ditt konto och arbetsflöde. Kontrollera en testkontakt, spara dess stabila id och hoppa över tomma e-postadresser före berikningssteget. Det tillgängliga intervallet för utlösaren är en inställning i plattformen och inget åtagande från GenderAPI.
Lägg till åtgärden Send any HTTP Request, välj POST och ange URL:en nedan. Konfigurera en JSON-kropp med type = email, value = kontaktens e-postadress och options.ai_mode = off.
Spara nyckeln med Pipedreams reglage för inloggningsuppgifter eller miljövariabler. Sätt Authorization till Bearer följt av hemligheten och Content-Type till application/json. Fortsätt inte att använda den inbyggda nyckelautentiseringen via frågesträngen och visa inte nyckeln i något steg.
Skapa kroppen som ett JSON-objekt med de mappningsreglage som åtgärden stöder. Sätt inte ihop rå JSON genom att sammanfoga kontaktvärden utan att maskera specialtecken. Granska förhandsvisningen av förfrågan innan du kör ett avgränsat test.

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": "email",
  "value": "alex@example.com",
  "options": {
    "ai_mode": "off"
  }
}

Fält, typer och standardvärden i förfrågan

Kontrollera HTTP-steget innan du aktiverar uppdateringar

Granska det svar som HTTP-steget exporterar och leta upp den tolkade kroppen. Om den valda åtgärden returnerar kroppen som text tolkar du den en gång innan du läser data och meta. Fältet data i transportomslaget är något annat än fältet data i V2-kroppen.

För ett kodbaserat arbetsflöde med uttrycklig styrning av tidsgränser, omdirigeringar och nya försök använder du den testade Node.js-guiden som länkas nedan. Den allmänna åtgärden och den inbyggda appen kan ha olika standardinställningar för transporten.

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 Twilio SendGrid

Spara det kontakt-id som utlösaren returnerar tillsammans med den tolkade V2-kroppen. Uppdatera bara de avsedda anpassade fälten i SendGrid efter de resultatkontroller som beskrivs ovan. Behåll det förnamn som kontakten har angett: ett data.name som härletts ur e-postadressen är en kandidat som tagits fram genom härledning och ingen kontrollerad ersättning.

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

Pipedream dokumenterar planberoende automatiska nya försök från det misslyckade steget. Granska de inställningarna och beteendet vid nya försök i den valda HTTP-åtgärden. Ett nytt försök i ett misslyckat berikningssteg kan medföra nya kostnader; ett senare fel i målsystemet bör repareras med den sparade utdatan från berikningen.

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

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

Använder den inbyggda GenderAPI.io-åtgärden i Pipedream V2?

Den offentliga komponent som granskades den 26 september 2026 använder äldre V1-slutpunkter och nyckelautentisering via frågesträngen. För en V2-förfrågan använder du det uttryckliga HTTP-receptet för V2 och granskar den publicerade komponenten igen om dess version ändras.

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 28 september 2026. 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.