# Yhdistä Pabbly Connect ja GenderAPI.io V2

> Yhdistä Pabbly Connect GenderAPI.io V2:een Shopify-tietueita varten. Valitse oikea yhteys, lähetä type ja value ja käsittele sitten data, meta, krediitit ja virheet.

Canonical HTML: https://www.genderapi.io/fi/blog/pabbly-gender-api-integration

Last reviewed: 2026-09-30

## Valitse Pabbly Connect -yhteys, joka vastaa API-määrittelyäsi

Tämän oppaan HTTP-määritys kutsuu GenderAPI.io V2:ta osoitteessa https://api.genderapi.io/api/v2/gender. Lähetä type ja value JSON-rungossa. Ennuste luetaan kentästä data ja pyynnön sekä laskutuksen tiedot kentästä meta. Valmiilla liittimillä on omat määrittelynsä, jotka kuvataan alla.

Pabbly-palvelun julkisessa luettelossa on sovellus nimeltä Gender API, mutta tarkistettu merkintä ei kerro tarjoajan verkkotunnusta, endpointin versiota eikä täydellistä vastausskeemaa. Pelkkä nimi ei osoita, että kyse on GenderAPI.io-palvelusta. Tarkista tarjoaja ja todelliset kentät ennen kuin valitset valmiin toiminnon.

Jos tarvitset nimenomaisesti V2-endpointin, käytä API by Pabbly -toiminnon mukautettua API-pyyntöä. Tämä ohje kuvaa kyseisen HTTP-pyynnön; se ei väitä, että valmis liitin olisi siirretty V2:een.

- [Pabbly-luettelon merkintä (tarjoajaa ei ole vahvistettu)](https://connect.pabbly.com/integrations/gender-api/)
- [Nykyinen V1-dokumentaatio](https://www.genderapi.io/fi/api-documentation/v1)

## Valmistele tili ja lähdetietue

Tämä esimerkki rikastaa Shopify-tietueita nimen perusteella. Tarvitset pääsyn lähde- ja kohdesovellukseen, GenderAPI.io-tilin API-avaimen sekä ne alustan ominaisuudet, joita HTTP-toiminto käyttää. Opas ei sisällä toimivia tunnistetietoja eikä yhdistettyjä tilejä.

V1 ja V2 käyttävät samaa tilin API-avainta ja samaa saldoa. Tarkista avain pyynnöllä GET /api/v2/usage ennen kuin määrität veloitettavan haun, ja varmista, että kentän meta.access.mode arvo on tämän endpointin vastauksessa api_key. Puuttuva tai tunnistamaton avain voi siirtyä käyttämään yhteistä IP-kokeilua, eikä tuotannon automaation pidä huomaamatta toimia sen varassa.

Pidä työnkulku poissa käytöstä sen määrittämisen ajan. Myös testiennusteen lähettäminen kuluttaa tavallisia krediittejä. Nämä ohjeet on tarkistettu julkista dokumentaatiota ja V2:n määrittelyä vasten; tätä julkaisua varten ei ajettu todennettua työnkulkua alusta loppuun millään alustalla.

- [Todennus ja maksuton käytön tarkistus](https://www.genderapi.io/fi/docs/v2/authentication#environment-setup)

## Määritä GenderAPI.io V2 -pyyntö Pabbly Connect -palvelussa

- Valitse tarvitsemaasi asiakastapahtumaan sopiva Shopify-käynnistin ja hae yksi edustava testitietue. Säilytä asiakkaan tunniste ja yhdistä saatavilla oleva etunimikenttä. Ohita tyhjä nimi äläkä korvaa sitä asiakkaan koko tietueella.
- Lisää API by Pabbly ja valitse Custom Request. Valitse POST ja alla oleva V2:n URL-osoite. Määritä Bearer token -todennus GenderAPI-avaimellasi tai Authorization-otsake, jonka koko arvo on Bearer YOUR_API_KEY; älä määritä molempia mekanismeja.
- Aseta Content-Type-arvoksi application/json. Custom Request tarjoaa JSON-rungolle Data-kentän. Muodosta objekti, jossa on type = name, value = yhdistetty etunimi ja options-objekti, joka sisältää ai_mode = off.
- Pidä options sisäkkäisenä objektina. Jos valittu toiminto tarjoaa vain raakaa JSON-tekstiä, varmista, että yhdistettyjen arvojen lainausmerkit, kenoviivat ja rivinvaihdot on koodattu oikein JSON-muotoon; käytä tuettua JSON-rakennusvaihetta sen sijaan, että lisäisit koodaamatonta asiakastekstiä suoraan.

| HTTP-asetus | Arvo | Tarkoitus |
| --- | --- | --- |
| `Method` | `POST` | Lähettää yhden ennustepyynnön. |
| `URL` | `https://api.genderapi.io/api/v2/gender` | GenderAPI.io V2:n endpoint yksittäisille ennusteille. |
| `Authorization` | `Bearer YOUR_API_KEY` | Korvaa paikkamerkki alustan todennus- tai otsakeasetuksissa. |
| `Content-Type` | `application/json` | Lähettää objektin, jonka sisällä on options-objekti, ei lomakekenttiä. |
| `options.ai_mode` | `off` | Tarkoituksellinen ensimmäinen testi pelkällä tietoaineistolla. Tavallinen veloitus on 1 krediitti, vaikka tulos olisi tuntematon. |

## Tarkista JSON-runko ennen lähettämistä

Tämä on kiinteä esimerkkisyöte, ei ennustettu tulos. Tarkista ensin pyynnön rakenne ja korvaa sitten kentän value arvo yhdistetyllä lähdekentällä, joka on sarjallistettu oikein JSON-muotoon. Älä lähetä alustan kenttien yhdistämislausekkeita API:lle kirjaimellisina merkkijonoina.

Jos syöte on toisenlainen, aseta type arvoon name, email tai username ja anna vastaava value. Lisää country vain, kun luotettava konteksti on saatavilla; kenttä on valinnainen eikä selvitä henkilön asuinmaata.

**Pabbly Connect -pyyntö GenderAPI.io V2:een**

```json
{
  "type": "name",
  "value": "Alice",
  "options": {
    "ai_mode": "off"
  }
}
```

- [Pyynnön kaikki kentät, tyypit ja oletusarvot](https://www.genderapi.io/fi/docs/v2/request-parameters)

## Tarkista HTTP-vaihe ennen päivitysten käyttöönottoa

Tarkista tallennettu vastausrunko ja varmista, että seuraava vaihe lukee V2-rungon eikä siirron tilakenttiä. Pabbly voi tuoda vastauksen avaimet näkyviin myöhempää kenttien yhdistämistä varten; tarkista niiden todellinen polku työnkulussasi.

Aja vain valittua testitoimintoa, kun määrität kulkua. Pyynnön lähettävä testi voi kuluttaa GenderAPI-krediittejä ja alustan tehtäviä jo ennen kuin työnkulku on otettu käyttöön.

- [Pabbly-tuki: Custom Request ja JSON-kenttä Data](https://forum.pabbly.com/threads/cannot-access-json-body-field-in-api-by-pabbly-module-even-after-correct-settings.29297/)
- [Merkintä Pabbly-palvelun julkisessa luettelossa (tarjoajaa ei ole vahvistettu)](https://connect.pabbly.com/integrations/gender-api/)

## Käsittele tulokset identified ja unknown sekä virheet erikseen

Jäsennä vastauksen runko ennen kuin valitset päivityksen kohdesovellukseen. Alla olevat JSON-polut viittaavat V2:n vastausrunkoon; alustasi voi kääriä tai litistää sen. Varmista todellinen palautettu rakenne harkitulla testillä ja pidä tulos liitettynä lähdetietueen tunnisteeseen.

Ennuste ei vahvista henkilön henkilöllisyyttä eikä hänen itse ilmoittamaansa sukupuolta. Säilytä se erillään tiedoista, jotka henkilö on itse antanut. Valitse hyväksymisehdot oman käyttötapauksesi näytön perusteella ja arvioi tietoaineiston ja tekoälyn luottamusarvot erikseen.

| Tarkistus | Odotettu arvo tai tyyppi | Päätös työnkulussa |
| --- | --- | --- |
| `meta.access.mode` | api_key tämän tilin työnkulussa | Pysäytä, jos arvo on ip_trial, ja korjaa avain. Onnistunut kokeiluvastaus ei todista tilin todennusta, ja se on voinut jo kuluttaa kokeilun krediittejä. |
| `meta.usage.billing_status` | confirmed tai unconfirmed | Jos arvo on unconfirmed, säilytä pyynnön tunniste ja pyydä laskutuksen täsmäytystä ennen uudelleenyritystä tai jatkamista. |
| `data.result_status / data.gender` | identified ja male tai female; unknown ja null | Ohjaa hyväksytyt identified-tulokset erilliseen päätellyn tiedon kenttään. Säilytä unknown-tulokset antamatta niille oletusluokkaa. |
| `data.confidence / data.confidence_kind` | luku väliltä 0–1 tai null; näytön tyyppi tai null | Tulkitse arvot observed_frequency ja model_reported erikseen; kumpikaan ei ole yleinen tarkkuustakuu. |
| `data.source / data.sample_count` | dataset, ai tai none / kokonaisluku tai null | Säilytä tieto siitä, miten ennuste saatiin. Tekoälytuloksella ei ole tallennettua otoskokoa, eikä tietoaineiston otoskoko ole tuotteen tarkkuuspistemäärä. |
| `meta.request_id / meta.usage` | pyynnön tunniste / käyttötietojen objekti | Tallenna ne työnkulun tietueen ja tuloksen yhteyteen. Pidä API-avaimet ja tarpeettomat henkilötiedot poissa tavallisista lokeista. |
| `HTTP-virhe / puuttuva vastaus` | Problem Details tai ei täydellistä vastausta | Keskeytä päivitys ja tarkista virhe ja laskutuksen tila. Aikakatkaisu ei todista, ettei palvelin tehnyt mitään työtä. |

- [API V2:n JSON-vastaukset ja luottamusarvot](https://www.genderapi.io/fi/docs/v2/responses)
- [Virheitä ja uudelleenyrityksiä koskevat päätökset](https://www.genderapi.io/fi/docs/v2/errors-and-retries)

## Päivitä vain oikea Shopify-tietue

Säilytä käynnistimen antama Shopify-asiakkaan tunniste. Ohjaa vahvistetut identified-tulokset tarkoitettuun asiakaskenttään tai tagikäytännön mukaisesti, säilytä unknown-tulokset arvona unknown ja jätä asiakkaan itse antama alkuperäinen nimi ennalleen. Tallenna source ja confidence_kind jokaisen hyväksytyn ennusteen yhteydessä.

Testaa tuloksen identified, tuntemattoman tuloksen ja virheen haarat ennen päivitysten käyttöönottoa. Keksittyjen esimerkkivastausten avulla voit testata haarojen ehdot lähettämättä uutta ennustepyyntöä. Kohdesovelluksen päivitys saa tapahtua vain, kun yllä olevat tarkistukset täyttyvät, eikä se saa korvata muita kenttiä tai tunnisteita.

- [Vastauskentät ja tuntemattomat tulokset](https://www.genderapi.io/fi/docs/v2/responses)
- [Tarkkuus ja luottamusarvo selitettynä](https://www.genderapi.io/fi/accuracy-methodology)
- [Tietolähteet ja päivätty tietoaineistoprofiili](https://www.genderapi.io/fi/data-provenance)

## Hallitse uudelleenlähetyksiä ja toistuvia veloituksia

Pabbly dokumentoi Auto Re-execution -toiminnon sekä manuaaliset vaihtoehdot epäonnistuneiden tai ohitettujen vaiheiden tai koko työnkulun uudelleensuorittamiseen. Tarkista, mitä ajetaan, ennen kuin käytät kumpaakaan vaihtoehtoa. Koko työnkulun uudelleensuorittaminen voi toistaa jo valmiin GenderAPI-haun; korjaa myöhempi Shopify-virhe mahdollisuuksien mukaan tallennetun vastauksen avulla.

Jokainen uusi GenderAPI-pyyntö on itsenäinen toiminto. Poista päällekkäiset lähdetapahtumat omassa työnkulussasi ennen lähettämistä tallennetun lähdetunnisteen ja käsittelytilan avulla. Lähdetietueen tunniste ei ole palvelinpuolen avain, joka estäisi uudelleenlähetykset.

Onnistunut tuntematon tulos on valmis tulos, josta veloitetaan. Aikakatkaisun tai keskeneräisen vastauksen jälkeen sekä tulos että veloitus voivat olla epäselviä. Säilytä pyynnön tunniste, jos se on saatavilla, ja täsmäytä veloitus ennen uutta lähetystä. Noudata pyyntörajoitusvastauksen Retry-After-otsaketta, jos se on mukana.

- [Krediitit ja laskutuksen tila](https://www.genderapi.io/fi/docs/v2/credits-and-usage)

## Päätä, milloin tekoälyä käytetään

forceToGenderize on valinnainen nimille, sähköpostiosoitteille ja käyttäjänimille. Kun se on käytössä, jätä ai_mode pois tai käytä arvoa fallback; off ja always ovat ristiriidassa sen kanssa ja palauttavat 422-virheen. Positiivinen alkusaldo riittää pyynnön aloittamiseen, vaikka lopullinen veloitus painaisi saldon negatiiviseksi.

Lempinimitila voi palauttaa sukupuolen, vaikka tuloksessa on name: null. Se voi myös palauttaa tuntemattoman tuloksen. Tavallinen tekoäly varalla ja lempinimipäättely eivät takaa oikeaa vastausta eivätkä muuta kuin null-arvoista vastausta.

| Pyynnön asetus | Toiminta | Krediitit onnistuneesta hausta |
| --- | --- | --- |
| options.ai_mode: off | Käyttää vain tietoaineistoa. | 1, myös tuntemattomasta tuloksesta |
| options.ai_mode: fallback | Hakee ensin tietoaineistosta ja käyttää tavallista tekoälyä, jos sukupuolta ei saada. Tämä on yksittäisen pyynnön oletus. | Yhteensä 1, tekoäly varalla mukaan lukien |
| options.ai_mode: always | Käyttää suoraan tekoälyä. | 2 |
| forceToGenderize: true | Hakee ensin tietoaineistosta ja sallii sitten tekoälyn tulkita henkilökohtaisen lempinimen tai aliaksen myös ilman todellista etunimeä. | 1 tietoaineistosta ratkaistusta tuloksesta; yhteensä 2, jos tekoälyä käytetään |

- [Tekoälyasetukset ja lempinimipäättely](https://www.genderapi.io/fi/docs/v2/ai-options)
- [Krediitit ja käyttö](https://www.genderapi.io/fi/docs/v2/credits-and-usage)

## Varmista työnkulku ennen määrän kasvattamista

- Tarkista yhdellä harkitulla testillä todellinen sarjallistettu JSON, jäsennetyn tuloksen polut, API-avaimella tapahtuva käyttö ja vahvistettu laskutus. Testaa unknown-tulosten ja virheiden ohjaus mahdollisuuksien mukaan valmiilla testivastauksilla.
- Varmista, mitkä työnkulun vaiheet yrittävät uudelleen ja mitkä asiakkaan kentät muuttuvat. Säilytä lähdetietueen tunniste, valmis vastaus ja pyynnön tunniste, jotta myöhempi virhe kohdesovelluksessa ei vaadi uutta hakua.
- Ota käyttöön pieni, valvottu ajo ja tarkista sen tietueet ja krediitit ennen kuin lisäät rinnakkaisuutta. GenderAPI-krediitit ja automaatioalustan tehtävä- tai toimintoveloitukset ovat erillisiä.
- Käytä eräpyyntöön reittiä POST /api/v2/gender/batch: enintään 50 kohdetta API-avaimella tai 10 kohdetta IP-kokeilussa. Taulukossa items voi yhdistää nimiä, sähköpostiosoitteita ja käyttäjänimiä, ja jokaisella kohteella on erikseen määritetyt asetukset ja yksilöllinen id. Tarkista jokainen tulos; HTTP 200 -vastaus voi sisältää osittaisia virheitä. Valmiin liittimen eräpyyntötuki on tarkistettava erikseen.

- [Eräpyynnöt ja osittaiset virheet](https://www.genderapi.io/fi/docs/v2/batch)
- [Python-toteutusopas](https://www.genderapi.io/fi/integrations/python)
- [Node.js-toteutusopas](https://www.genderapi.io/fi/integrations/javascript)

## Voinko käyttää Pabbly-palvelussa litteää lomakekenttää options.ai_mode?

V2:n POST-runko tarvitsee JSON-objektin options. Piste kentän nimessä ei yksinään todista, että alusta tekee siitä sisäkkäisen. Tarkista sarjallistettu runko ja varmista, että se vastaa esimerkkiä, ennen kuin ajat pyynnön.

## Salliiko suora HTTP-esimerkki tekoälyn käytön?

Ensimmäisen pyynnön runko asettaa kentän options.ai_mode arvoksi off. Vaihda arvo harkiten arvoon fallback, jos haluat tavallisen tekoälyn varalla yhteensä 1 krediitillä, tai arvoon always, jos haluat käyttää tekoälyä 2 krediitillä. forceToGenderize hakee ensin tietoaineistosta ja maksaa 1 krediitin, jos tulos ratkeaa siellä, tai yhteensä 2 krediittiä, kun tekoälyä käytetään.

## Onko tuntematon tulos maksuton, tai onko sitä turvallista yrittää automaattisesti uudelleen?

Ei. Onnistunut tuntematon tulos on valmis ja veloitettava. Uusi yritys on uusi toiminto. Siirtovirheissä tai vahvistamattomassa laskutuksessa tarkista palautetut käyttötiedot ja pyynnön tunniste ennen kuin päätät lähettää pyynnön uudelleen.

## Ajettiinko tämä työnkulku yhdistetyllä tilillä?

Ei. Alustojen määritysohjeet tarkistettiin julkista dokumentaatiota vasten 26. syyskuuta 2026. GenderAPI.io V2:n pyyntöä ja vastausta koskevat selitykset tarkistettiin 27. syyskuuta 2026. Tämän suomenkielisen version tarkistus 30. syyskuuta 2026 on käännöksen tarkistus eikä uusi testi tilillä. Testaa valitun toiminnon nykyiset kentät, todennus, runko, vastaus ja uudelleenyritykset omalla tililläsi ennen kuin otat päivitykset käyttöön tuotannossa.

## Lähteet ja dokumentaatio

- [Pabbly-tuki: mukautetut REST-pyynnöt ja uudelleensuoritus](https://forum.pabbly.com/threads/how-to-track-node-level-logs-enable-retries-and-use-rest-api-integrations-in-pabbly-connect.214474/)
- [Pabbly-tuki: Custom Request ja JSON-kenttä Data](https://forum.pabbly.com/threads/cannot-access-json-body-field-in-api-by-pabbly-module-even-after-correct-settings.29297/)
- [Merkintä Pabbly-palvelun julkisessa luettelossa (tarjoajaa ei ole vahvistettu)](https://connect.pabbly.com/integrations/gender-api/)
- [GenderAPI.io V2:n pyyntömäärittely](https://www.genderapi.io/fi/docs/v2/request-parameters)
- [GenderAPI.io V2:n vastausten määrittely](https://www.genderapi.io/fi/docs/v2/responses)
- [GenderAPI.io V2:n laskutus ja krediitit](https://www.genderapi.io/fi/docs/v2/credits-and-usage)