Siirrä integraatio V1:stä V2:een
V1 on edelleen käytettävissä. Siirrä integraatiot yksi kerrallaan, kun olet valmis, samalla avaimella ja krediittisaldolla. V2:ssa on eri pyyntö- ja vastausrakenne, joten pelkkä URL-osoitteen vaihtaminen ei riitä.
| GenderAPI.io V1 | GenderAPI.io V2 |
|---|---|
| /api, /api/email, /api/username | POST /api/v2/gender kentillä type (name, email tai username) ja value. |
| /api/name/multi/country, /api/email/multi/country, /api/username/multi/country | POST /api/v2/gender/batch kentällä items; syötetyyppejä voi yhdistellä. |
| /api/phone kentillä number ja address | POST /api/v2/phone/validate kentillä number ja country; lue data.valid ja data.possible. |
| askToAI | options.ai_mode: fallback; yksittäisten pyyntöjen oletusarvo on jo fallback |
| forceToGenderize | Sama valinnainen kenttä kaikille kolmelle tyypille; ensin tietoaineisto, sitten lempinimiä tulkitseva tekoäly |
| Litteät vastauskentät | data sisältää tuloksen; meta käyttöoikeuden ja laskutuksen tiedot |
| probability prosentteina | confidence asteikolla 0–1 sekä confidence_kind; tekoälyn pistemäärät eivät ole kalibroituja todennäköisyyksiä |
| total_names | data.sample_count, voi olla null |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Vanha virhemuoto | HTTP-tila sekä Problem Details -kentät code ja action |
| POST-pyyntöjen uudelleenyritykset | Jokainen uudelleenyritys on uusi toiminto normaalilla laskutuksella |
Päivitä ja tarkista asiakasohjelmasi
Käytä siirrettävässä integraatiossa V2:n pyyntö- ja vastausrakennetta. Tarkista meta.access.mode, säilytä JSON null -tulokset, tarkista erän kohdekohtaiset virheet ja tarkista laskutus ennen uudelleenyritystä. Pidä V1-integraatiot nykyisillä poluillaan, kunnes niiden asiakasohjelmat on päivitetty.