Yhdistä Make ja GenderAPI.io V2

Valitse Make-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.

Make tarjoaa GenderAPI.io-sovelluksen, jossa on toiminnot nimille ja sähköpostiosoitteille. Sen julkinen sivu linkittää osoitteeseen genderapi.io, mutta ei näytä endpointin täydellistä versiota eikä vastausskeemaa. Tarkista valitun moduulin todellinen tuloste ennen kuin yhdistät kenttiä olemassa olevissa skenaarioissa.

Jos haluat V2:n toiminnan nimenomaisesti, käytä Make-palvelun HTTP-sovellusta ja alla olevaa pyyntöä. HTTP-määritys ei päivitä olemassa olevaa GenderAPI-moduulia uuteen versioon; pidä toimivat skenaariot erillään, kunnes korvaava ratkaisu on tarkistettu.

Valmistele tili ja lähdetietue

Tämä esimerkki rikastaa Shopify-tietueita sähköpostiosoitteen 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

Määritä GenderAPI.io V2 -pyyntö Make-palvelussa

Valitse skenaarioosi sopiva Shopify-asiakaskäynnistin ja lataa edustava testitietue. Säilytä asiakkaan tunniste lopullista päivitystä varten ja ohita tietueet, joissa sähköpostiosoite on tyhjä.
Lisää HTTP > Make a request. Valitse nykyisessä HTTP-sovelluksessa API-avaintodennus ja luo tunnistetieto, jossa avaimen arvo on Bearer YOUR_API_KEY, sijainti Header ja parametrin nimi Authorization. Käytä tunnistetietojen säilöä äläkä lisää avainta URL-osoitteeseen.
Aseta metodiksi POST ja URL-osoitteeksi alla näkyvä osoite. Valitse pyynnön rungolle application/json ja tietorakenne, jossa on merkkijonokentät type ja value sekä options-kokoelma, joka sisältää merkkijonokentän ai_mode. Aseta type arvoon email ja ai_mode arvoon off, ja yhdistä asiakkaan sähköpostiosoite kenttään value.
Ota käyttöön Parse response. Make-palvelun tietorakenteeseen perustuva runko sarjallistaa yhdistetyt arvot JSON-muotoon, joten lainausmerkkejä sisältävät nimet tai osoitteet eivät vaadi merkkijonojen kokoamista käsin.

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.

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

Pyynnön kaikki kentät, tyypit ja oletusarvot

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

Pidä uudelleenohjaukset poissa käytöstä tässä kiinteässä HTTPS-kohteessa. Kun vaihdat Make-palvelun HTTP-sovelluksen versiota, tarkista todennus- ja runkoasetukset uudelleen, sillä niiden säätimet voivat poiketa toisistaan.

Suorita yksi harkittu testi, tarkista jäsennetty vastauspaketti (bundle) ja luo erilliset reitit hyväksytyille identified-tuloksille, unknown-tuloksille ja toiminnallisille virheille ennen kuin lisäät asiakkaan päivityksen.

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ä.

Päivitä vain oikea Shopify-tietue

Yhdistä jäsennetyssä HTTP-vastauksessa alla olevat V2:n rungon polut. Make voi sijoittaa rungon moduulin tulosteen nimen alle; valitse sisäkkäiset objektit data ja meta tarkistamastasi paketista. Päivitä vain se asiakas, jonka tunnisteen käynnistin tallensi, ja käytä erillistä päätellyn tiedon kenttää tai sovittua tagikäytäntöä.

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.

Hallitse uudelleenlähetyksiä ja toistuvia veloituksia

Tarkista Make-palvelun virheenkäsittelijät ja keskeneräisten suoritusten asetukset. Joitakin tilapäisiä virheitä voidaan yrittää uudelleen myös ilman erikseen lisättyä Retry-käsittelijää. HTTP-moduulin uudelleenyritys voi lähettää uuden veloitettavan haun. Jos haku onnistui mutta myöhempi Shopify-päivitys epäonnistui, käytä tallennettua hakutulosta, kun korjaat kyseisen päivityksen.

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

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

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.

Usein kysytyt kysymykset

Pitäisikö API-avain liittää Make-palvelun URL-osoitteeseen?

Ei. Tallenna V2:n HTTP-ohjeessa Bearer YOUR_API_KEY HTTP-sovelluksen API-avaintunnistetietoon niin, että sijainti on Header ja parametrin nimi Authorization. POST-endpoint ei hyväksy kyselyparametria key.

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

Suomenkielinen versio tarkistettiin viimeksi 30. syyskuuta 2026. Alustojen tiedot perustuvat niiden julkiseen dokumentaatioon, joka tarkistettiin 26. syyskuuta 2026. Tarkistus ei ollut uusi testi yhdistetyllä tilillä. Tarkista ajantasainen määritys ja saatavuus kunkin alustan virallisesta dokumentaatiosta.