Collegare Pabbly Connect a GenderAPI.io V2

Scegli la connessione Pabbly Connect 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.

La directory pubblica di Pabbly contiene un'app chiamata Gender API, ma la scheda verificata non indica né il dominio del fornitore né la versione dell'endpoint né lo schema completo della risposta. Il nome da solo non dimostra che si tratti di GenderAPI.io. Verifica il fornitore e i campi effettivi prima di scegliere un'azione nativa.

Per usare un endpoint V2 esplicito, usa la funzione per richieste API personalizzate di API by Pabbly. Questa ricetta descrive quella richiesta HTTP; non afferma che il connettore nativo sia stato migrato a V2.

Prepara l'account e il record di origine

Questo esempio arricchisce i record di Shopify a partire dal nome. 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 Pabbly Connect

Scegli un trigger Shopify adatto all'evento cliente che ti serve e acquisisci un record di prova rappresentativo. Salva l'ID del cliente e mappa il campo disponibile del nome. Salta un nome vuoto invece di sostituirlo con l'intero record del cliente.
Aggiungi API by Pabbly e scegli Custom Request. Scegli POST e l'URL V2 qui sotto. Configura l'autenticazione con Bearer token e la chiave GenderAPI, oppure un'intestazione Authorization il cui valore completo è Bearer YOUR_API_KEY; non configurare entrambi i meccanismi contemporaneamente.
Imposta Content-Type su application/json. Custom Request ha un campo Data per il corpo JSON. Crea un oggetto con type = name, value = nome mappato e un oggetto options con ai_mode = off. L'intestazione Content-Type descrive il corpo indicato; non trasforma da sola i campi di un modulo in un oggetto JSON.
Mantieni options annidato. Se l'azione scelta accetta solo JSON grezzo, assicurati che virgolette, barre rovesciate e interruzioni di riga nei valori mappati siano codificate correttamente in JSON; usa un passaggio supportato per creare il JSON invece di inserire testo del cliente non codificato.

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": "name",
  "value": "Alice",
  "options": {
    "ai_mode": "off"
  }
}

Campi, tipi e valori predefiniti della richiesta

Verifica il passaggio HTTP prima di attivare gli aggiornamenti

Esamina il corpo della risposta acquisito e assicurati che il passaggio successivo legga il corpo V2 e non i campi di stato del trasporto. Pabbly può rendere disponibili le chiavi della risposta per la mappatura successiva; verifica il loro percorso effettivo nel tuo flusso di lavoro.

Durante la configurazione esegui solo l'azione di prova scelta. Un test che invia una richiesta può consumare crediti GenderAPI e attività della piattaforma già prima che il flusso di lavoro sia attivato.

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 Shopify

Salva l'ID del cliente Shopify fornito dal trigger. Indirizza i risultati identified confermati al campo cliente previsto o secondo la policy per i tag, mantieni i risultati unknown come unknown e non modificare il nome indicato dal cliente. Salva source e confidence_kind per ogni previsione accettata.

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

Pabbly documenta Auto Re-execution e opzioni manuali per rieseguire passaggi non riusciti o saltati oppure l'intero flusso di lavoro. Verifica che cosa viene eseguito prima di usare una di queste opzioni. Rieseguire l'intero flusso di lavoro può ripetere una richiesta GenderAPI già completata; se possibile, correggi un errore successivo in Shopify con la risposta salvata.

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

Posso usare in Pabbly un campo di modulo piatto options.ai_mode?

Il corpo V2 per POST richiede un oggetto JSON options. Un punto nell'etichetta del campo non dimostra da solo che la piattaforma crei un oggetto annidato. Verifica il corpo serializzato prima di inviare la richiesta e assicurati che corrisponda all'esempio.

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.