# Siirrä GenderAPI v1:stä v2:een

> Siirrä GenderAPI-integraatio v1:stä v2:een käyttämällä samaa API-avainta ja tasapainoa. Kartoittaa pyyntökentät, eräreitit, vastaukset, virheet ja uudelleenyrityskäyttäytyminen.

Canonical HTML: https://www.genderapi.io/fi/docs/v2/migration

Last reviewed: 2026-09-26

## Siirrä integraatio v1:stä v2:een

V1 on edelleen saatavilla. Siirrä yksittäiset integraatiot, kun olet valmis käyttämällä samaa avainta ja saldoa. V2 on erilainen pyyntö- ja vastaussopimus, joten pelkän URL-osoitteen muuttaminen ei riitä.

| V1-konsepti | V2-vastaava |
| --- | --- |
| Erilliset nimen, sähköpostiosoitteen ja käyttäjänimen päätepisteet | POST /api/v2/gender ja type ja value |
| Erottele useita päätepisteitä | POST /api/v2/gender/batch ja items |
| askToAI | options.ai_mode: fallback; yksittäisten pyyntöjen oletusarvo on jo fallback |
| forceToGenderize | Sama valinnainen kenttä kaikille kolmelle tyypille; tietojoukko ensin, sitten lempinimitietoinen tekoäly |
| Tasaiset vastauskentät | data tulokselle; meta pääsyä ja laskutusta varten |
| probability prosenttiosuus | confidence asteikolla 0–1 plus confidence_kind; AI-pisteet eivät ole kalibroituja todennäköisyyksiä |
| total_names | data.sample_count, mitätöitävissä |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Vanha virhemuoto | HTTP tila plus Problem Details code ja action |
| POST yrittää uudelleen | Jokainen uudelleenyritys on uusi toiminto normaalilla laskutuksella |

- [Lue v1-viite](https://www.genderapi.io/fi/api-documentation/v1)
- [Käytä v2 OpenAPI -sopimusta](https://api.genderapi.io/api/v2/openapi.json)

## Päivitä ja vahvista asiakkaasi

Käytä siirrettävän integroinnin v2-pyyntö- ja vastaussopimusta. Tarkista meta.access.mode, säilytä JSON null -tulokset, tarkasta tuotekohtaiset erävirheet ja tarkista laskutus ennen kuin yrität uudelleen. Pidä v1-integraatiot olemassa olevilla poluilla, kunnes heidän asiakkaat on päivitetty.

- [Aloita todennuksella](https://www.genderapi.io/fi/docs/v2/authentication)
- [Lue v2-vastaus](https://www.genderapi.io/fi/docs/v2/responses)
- [Käsittele uudelleenyritykset](https://www.genderapi.io/fi/docs/v2/errors-and-retries)