Collegare Pipedream a GenderAPI.io V2

Scegli la connessione Pipedream adatta al tuo contratto API

La ricetta HTTP di questa guida chiama GenderAPI.io V2 su https://api.genderapi.io/api/v2/gender. Invia type e value nel corpo JSON; la previsione si legge in data, mentre i dati della richiesta e dell'addebito si trovano in meta. I connettori nativi hanno contratti propri, descritti qui sotto.

Il componente pubblico GenderAPI.io di Pipedream, verificato il 26 settembre 2026, usa la vecchia base https://api.genderapi.io/api e invia name o email, country facoltativo e la chiave API come parametri di query. L'implementazione pubblicata è un connettore V1 e non un endpoint JSON V2.

Puoi mantenere l'azione nativa esistente con il suo contratto oppure aggiungere un passaggio HTTP generico per V2. Non presupporre che l'autenticazione automatica dell'account collegato in modo nativo sia adatta a questa richiesta V2 separata: la ricetta usa esplicitamente un'intestazione Bearer.

Prepara l'account e il record di origine

Questo esempio arricchisce i record di Twilio SendGrid a partire dall'indirizzo email. Ti servono l'accesso all'applicazione di origine e a quella di destinazione, una chiave dell'account GenderAPI.io e le funzioni della piattaforma usate dall'azione HTTP. Questa guida non contiene credenziali funzionanti né account collegati.

V1 e V2 usano la stessa chiave dell'account e lo stesso saldo. Prima di configurare una richiesta a pagamento, verifica la chiave con GET /api/v2/usage e controlla che nella risposta di questo endpoint meta.access.mode abbia il valore api_key. Una chiave mancante o non riconosciuta può far passare alla prova IP condivisa; un'automazione in produzione non dovrebbe dipenderne a tua insaputa.

Tieni il flusso di lavoro disattivato mentre lo configuri. Una previsione di prova consuma crediti normali. Queste guide sono state verificate sulla documentazione pubblica e sul contratto V2; per questa pubblicazione non è stato eseguito da inizio a fine alcun flusso di lavoro autenticato su nessuna piattaforma.

Autenticazione e controllo gratuito dell'utilizzo

Configura la richiesta GenderAPI.io V2 in Pipedream

Scegli un evento Twilio SendGrid o una pianificazione adatti al tuo account e al tuo flusso di lavoro. Verifica un contatto di prova, salvane l'ID stabile e salta gli indirizzi email vuoti prima del passaggio di arricchimento. L'intervallo disponibile per il trigger è un'impostazione della piattaforma e non un impegno di GenderAPI.
Aggiungi l'azione Send any HTTP Request, scegli POST e inserisci l'URL qui sotto. Configura un corpo JSON con type = email, value = indirizzo email del contatto e options.ai_mode = off.
Salva la chiave con i controlli di Pipedream per le credenziali o le variabili d'ambiente. Imposta Authorization su Bearer seguito dal segreto e Content-Type su application/json. Non continuare a usare l'autenticazione nativa con la chiave nella stringa di query e non mostrare la chiave in nessun passaggio.
Crea il corpo come oggetto JSON con i controlli di mappatura supportati dall'azione. Non comporre JSON grezzo concatenando i valori del contatto senza l'escape dei caratteri speciali. Controlla l'anteprima della richiesta prima di eseguire un test circoscritto.

Impostazione HTTP	Valore	Scopo
`Method`	`POST`	Invia una singola richiesta di previsione.
`URL`	`https://api.genderapi.io/api/v2/gender`	Endpoint V2 di GenderAPI.io per le previsioni singole.
`Authorization`	`Bearer YOUR_API_KEY`	Sostituisci il segnaposto tramite le impostazioni di autenticazione o delle intestazioni della piattaforma.
`Content-Type`	`application/json`	Invia un oggetto con un oggetto options annidato, non campi di un modulo.
`options.ai_mode`	`off`	Primo test deliberato solo con il set di dati: addebito normale di 1 credito, anche se il risultato è unknown.

Controlla il corpo JSON prima dell'invio

Questo esempio mostra un input fisso; non è un risultato previsto. Verifica prima la struttura della richiesta, poi sostituisci value con il campo di origine mappato, usando una serializzazione JSON corretta. Non inviare all'API le espressioni di mappatura della piattaforma come testo letterale.

Per altri input imposta type su name, email o username e indica il valore corrispondente in value. Aggiungi country solo se disponi di un contesto affidabile: il campo è facoltativo e non serve a stabilire il paese di residenza.

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

Campi, tipi e valori predefiniti della richiesta

Verifica il passaggio HTTP prima di attivare gli aggiornamenti

Esamina la risposta esportata dal passaggio HTTP e individua il corpo analizzato. Se l'azione scelta restituisce il corpo come testo, analizzalo una volta prima di leggere data e meta. Il campo data dell'involucro di trasporto è diverso dal campo data del corpo V2.

Per un flusso di lavoro basato su codice con controllo esplicito di timeout, reindirizzamenti e nuovi tentativi, usa la guida Node.js testata indicata qui sotto. L'azione generica e l'app nativa possono avere impostazioni di trasporto predefinite diverse.

Gestisci separatamente i risultati identified, unknown e gli errori

Analizza il corpo della risposta prima di scegliere un aggiornamento nel sistema di destinazione. I percorsi JSON qui sotto si riferiscono al corpo della risposta V2; la tua piattaforma può incapsularlo o appiattirlo. Verifica la struttura effettivamente restituita con un test circoscritto e salva il risultato insieme all'ID del record di origine.

Una previsione non stabilisce né l'identità di una persona né il genere che la persona dichiara. Conservala separatamente dai dati forniti dalla persona stessa. Definisci i criteri di accettazione su dati rappresentativi del tuo caso d'uso e valuta separatamente la confidenza del set di dati e la confidenza dell'IA.

Controllo	Valore o tipo atteso	Decisione nel flusso di lavoro
`meta.access.mode`	api_key per questo flusso di lavoro con account	Interrompi il flusso di lavoro se il valore è ip_trial e correggi la chiave. Una risposta riuscita della prova IP non dimostra che l'account sia stato autenticato e potrebbe aver già consumato crediti della prova.
`meta.usage.billing_status`	confirmed o unconfirmed	Se il valore è unconfirmed, salva l'ID della richiesta e chiarisci l'addebito prima di un nuovo tentativo o di proseguire.
`data.result_status / data.gender`	identified con male o female; unknown con null	Salva i risultati identified accettati in un campo dedicato ai dati dedotti. Mantieni i risultati unknown senza assegnare una categoria predefinita.
`data.confidence / data.confidence_kind`	Numero da 0 a 1 o null; tipo di evidenza o null	Interpreta observed_frequency e model_reported separatamente; nessuno dei due valori garantisce un'accuratezza generale.
`data.source / data.sample_count`	dataset, ai o none / numero intero o null	Salva l'origine della previsione. L'IA non ha una dimensione del campione memorizzata; una dimensione del campione del set di dati non è una misura dell'accuratezza del prodotto.
`meta.request_id / meta.usage`	Riferimento della richiesta / oggetto di utilizzo	Salva entrambi insieme al record del flusso di lavoro e al risultato. Non scrivere chiavi API o dati personali superflui nei log ordinari.
`Errore HTTP / nessuna risposta`	Problem Details o nessuna risposta completa	Interrompi l'aggiornamento e verifica l'errore e lo stato dell'addebito. Un timeout non dimostra che il server non abbia elaborato nulla.

Aggiorna solo il record corrispondente in Twilio SendGrid

Salva l'ID del contatto restituito dal trigger insieme al corpo V2 analizzato. Aggiorna solo i campi personalizzati previsti in SendGrid dopo i controlli sui risultati descritti sopra. Mantieni il nome indicato dal contatto: un data.name ricavato dall'indirizzo email è un candidato ottenuto per deduzione e non una sostituzione verificata.

Prova i rami per un risultato identified, un risultato unknown e un errore prima di attivare gli aggiornamenti. Con risposte di esempio fittizie puoi verificare le condizioni della diramazione senza inviare una nuova previsione. L'aggiornamento nell'applicazione di destinazione deve dipendere dai controlli indicati sopra e non deve sovrascrivere campi o tag non correlati.

Controlla i nuovi tentativi e gli addebiti ripetuti

Pipedream documenta nuovi tentativi automatici, dipendenti dal piano, a partire dal passaggio non riuscito. Verifica queste impostazioni e il comportamento dei nuovi tentativi dell'azione HTTP scelta. Un nuovo tentativo in un passaggio di arricchimento non riuscito può comportare nuovi costi; un errore successivo nel sistema di destinazione va corretto con l'output salvato dell'arricchimento.

Ogni nuova richiesta a GenderAPI è un'operazione a sé. Elimina i duplicati degli eventi di origine ripetuti nel tuo flusso di lavoro prima dell'invio, usando l'ID di origine salvato e lo stato di elaborazione. L'ID del record di origine non è una chiave che protegge dalle ripetizioni lato server.

Un risultato unknown riuscito è un risultato completo che viene addebitato. In caso di timeout o di risposta incompleta, il risultato e l'addebito possono essere sconosciuti: salva il riferimento della richiesta, se disponibile, e chiarisci l'addebito prima di inviare di nuovo la richiesta. Rispetta l'intestazione Retry-After quando accompagna una risposta di limite di richieste superato.

Crediti e stato dell'addebito

Decidere quando usare l'IA

forceToGenderize è facoltativo per nomi, indirizzi email e nomi utente. Quando è attivo, ometti ai_mode o usa fallback; off e always non possono essere combinati con questa opzione e restituiscono 422. Un saldo iniziale positivo basta per avviare una richiesta, anche se l'addebito finale rende il saldo negativo.

La modalità nickname può restituire un genere insieme a name: null. Può anche dare un risultato sconosciuto. Né il normale fallback IA né l'interpretazione dei nickname garantiscono una risposta corretta o un valore diverso da null.

Opzione della richiesta	Comportamento	Crediti per una ricerca riuscita
options.ai_mode: off	Usa solo il set di dati.	1, anche per un risultato sconosciuto
options.ai_mode: fallback	Consulta prima il set di dati e poi usa la normale IA se non viene restituito un genere. È il valore predefinito per le richieste singole.	1 in totale, fallback IA incluso
options.ai_mode: always	Usa direttamente l'IA.	2
forceToGenderize: true	Consulta prima il set di dati e poi lascia che l'IA interpreti un nickname personale o un alias, anche senza un vero nome proprio.	1 per un risultato trovato nel set di dati; 2 in totale se viene usata l'IA

Verifica il flusso di lavoro prima di aumentare il volume

Con un test circoscritto verifica il JSON effettivamente serializzato, i percorsi dei risultati analizzati, l'accesso con chiave API e la conferma dell'addebito. Se possibile, prova con risposte di esempio la gestione dei risultati unknown e degli errori.
Chiarisci quali passaggi del flusso di lavoro vengono ripetuti e quali campi del cliente vengono modificati. Salva l'ID del record di origine, la risposta ricevuta e il riferimento della richiesta, così un errore successivo nel sistema di destinazione non richiede un'altra richiesta.
Attiva prima un'esecuzione piccola e controllata e verificane record e crediti prima di aumentare il parallelismo. I crediti GenderAPI e le attività o operazioni addebitate dalla piattaforma di automazione sono costi separati.
Per i batch usa POST /api/v2/gender/batch con fino a 50 elementi con accesso tramite chiave API o 10 con la prova IP. L'array items può combinare nomi, indirizzi email e nomi utente, con opzioni esplicite e un id univoco per ogni elemento. Controlla ogni risultato: una risposta HTTP 200 può contenere errori di singoli elementi. Il supporto dei batch in un connettore nativo va verificato separatamente.

Domande frequenti

L'azione nativa GenderAPI.io di Pipedream usa V2?

Il componente pubblico verificato il 26 settembre 2026 usa i vecchi endpoint V1 e l'autenticazione con la chiave nella stringa di query. Per una richiesta V2 usa la ricetta HTTP esplicita per V2 e verifica di nuovo il componente pubblicato se la sua versione cambia.

L'esempio HTTP diretto consente l'uso dell'IA?

Il corpo della prima richiesta imposta options.ai_mode su off. Cambia deliberatamente il valore in fallback per usare il normale fallback IA per 1 credito in totale, oppure in always per usare direttamente l'IA per 2 crediti. forceToGenderize consulta prima il set di dati: costa 1 credito se la richiesta viene risolta lì, oppure 2 in totale se viene usata l'IA.

Un risultato unknown è gratuito e può essere ripetuto automaticamente senza rischi?

No. Un risultato unknown riuscito è completo e viene addebitato. Un nuovo tentativo è una nuova ricerca. In caso di errore di trasporto o di addebito non confermato, controlla i dati di utilizzo restituiti e il riferimento della richiesta prima di decidere se inviarla di nuovo.

Questo flusso di lavoro è stato eseguito con un account collegato?

No. Le istruzioni di configurazione delle piattaforme sono state verificate il 26 settembre 2026 sulla loro documentazione pubblica. Le spiegazioni sulla richiesta e sulla risposta di GenderAPI.io V2 sono state verificate il 27 settembre 2026. La revisione di questa versione italiana del 28 settembre 2026 è una verifica della traduzione e non un nuovo test con un account. Prima di attivare gli aggiornamenti in produzione, verifica con il tuo account i campi attuali dell'azione scelta, l'autenticazione, il corpo della richiesta, la risposta e i nuovi tentativi.

Documentazione di riferimento

La versione italiana è stata verificata l'ultima volta il 28 settembre 2026. Le informazioni sulle piattaforme si basano sulla loro documentazione pubblica, verificata il 26 settembre 2026. Questa verifica non è un nuovo test con un account collegato. Controlla la configurazione e la disponibilità attuali nella documentazione ufficiale delle piattaforme.