# GenderAPI.io V2 -dokumentaatio

> Lähetä ensimmäinen pyyntösi, yhdistä sovelluksesi ja opi tulkitsemaan tulokset. Aloita nimellä, sähköpostiosoitteella tai käyttäjänimellä.

Canonical HTML: https://www.genderapi.io/fi/api-documentation

Last reviewed: 2026-09-30

## Lähetä ensimmäinen pyyntösi

Lähetä nimi, sähköpostiosoite tai käyttäjänimi, niin saat sukupuoliennusteen JSON-muodossa. Kokeile alla olevaa URL-osoitetta selaimessa ilman API-avainta ja valitse sitten opas sovelluksesi yhdistämiseen.

Maksuton kokeilu sisältää 10 krediittiä IP-osoitetta kohden 24 tunnin jaksossa, ja kiintiö on yhteinen V1:n kanssa. Tämä vain tietoaineistoa käyttävä esimerkki maksaa 1 krediitin pyyntöä kohden, myös jokaisella sivun päivityksellä. Kun yhdistät nykyisen API-avaimesi, V1 ja V2 käyttävät samaa tilin saldoa.

```text
https://api.genderapi.io/api/v2/gender?type=name&value=Emilia&country=FI&ai_mode=off
```

- [Avaa GET-esimerkki (käyttää 1 kokeilukrediitin)](https://api.genderapi.io/api/v2/gender?type=name&value=Emilia&country=FI&ai_mode=off)
- [Määritä API-avain](https://www.genderapi.io/fi/docs/v2/authentication#environment-setup)
- [Tulkitse JSON-vastaus](https://www.genderapi.io/fi/docs/v2/responses)

## Mitä haluat tehdä?

Valitse syötetyyppi, niin näet toimivat esimerkit kielillä cURL, JavaScript, Python, PHP, Java, C# ja Go. Tulos- ja laskutusoppaat auttavat, kun olet valmis käsittelemään todellisia vastauksia.

- [API-avain ja maksuton kokeilu](https://www.genderapi.io/fi/docs/v2/authentication): Yhdistä API-avaimesi tai kokeile API:a maksutta.
- [Pyyntöparametrit](https://www.genderapi.io/fi/docs/v2/request-parameters): Valitse syötekentät, maakonteksti ja pyynnön asetukset.
- [Viralliset SDK:t](https://www.genderapi.io/fi/docs/v2/sdks): Asenna ohjelmointikielellesi virallinen asiakaskirjasto.
- [Sukupuolen arviointi nimestä](https://www.genderapi.io/fi/docs/v2/gender-from-name): Hae etunimellä tai koko nimellä.
- [Sukupuolen arviointi sähköpostista](https://www.genderapi.io/fi/docs/v2/gender-from-email): Etsi nimisignaali sähköpostiosoitteesta.
- [Sukupuolen arviointi käyttäjänimestä](https://www.genderapi.io/fi/docs/v2/gender-from-username): Käytä syötteenä käyttäjänimeä tai lempinimeä.
- [Eräpyynnöt (batch)](https://www.genderapi.io/fi/docs/v2/batch): Käsittele enintään 50 nimeä, sähköpostiosoitetta tai käyttäjänimeä kerralla.
- [Puhelinnumeron tarkistus](https://www.genderapi.io/fi/docs/v2/phone-validation): Tarkista ja muotoile puhelinnumero.
- [Vastauksen tulkinta](https://www.genderapi.io/fi/docs/v2/responses): Tulkitse ennusteet, luottamusarvot ja tuntemattomat tulokset.
- [Tekoäly ja lempinimet](https://www.genderapi.io/fi/docs/v2/ai-options): Valitse, milloin tekoälyä käytetään ja miten lempinimiä käsitellään.
- [Krediitit ja saldo](https://www.genderapi.io/fi/docs/v2/credits-and-usage): Tarkista saldosi ja kunkin pyynnön hinta.
- [Virheet ja uudelleenyritykset](https://www.genderapi.io/fi/docs/v2/errors-and-retries): Ratkaise virheet ja päätä, milloin pyyntö kannattaa yrittää uudelleen.
- [Siirtyminen V1:stä](https://www.genderapi.io/fi/docs/v2/migration): Päivitä nykyinen integraatio samalla API-avaimella.

## Päätepisteiden kuvaus

Yhdistä https://api.genderapi.io tämän taulukon absoluuttisiin polkuihin, esimerkiksi https://api.genderapi.io/api/v2/gender. Kyselyparametreja tuetaan vain reitillä GET /gender. Käytä POST-reiteillä JSON-runkoa; älä lähetä V2-pyynnössä V1:n kenttiä, kuten name, email, username tai askToAI.

| Metodi | Polku | Tarkoitus |
| --- | --- | --- |
| GET | /api/v2 | Julkiset ominaisuudet ja nykyiset rajat; maksuton. |
| GET | /api/v2/openapi.json | Kanoninen OpenAPI-määrittely; maksuton. |
| GET | /api/v2/errors | Koneluettava virheluettelo; ilmainen. |
| GET | /api/v2/usage | Tilin tai IP-kokeilun nykyinen saldo; maksuton. |
| GET / POST | /api/v2/gender | Yksi nimi, sähköpostiosoite tai käyttäjänimi. |
| POST | /api/v2/gender/batch | Järjestetty erä nimiä, sähköpostiosoitteita ja/tai käyttäjänimiä. |
| POST | /api/v2/phone/validate | Tarkista ja muotoile puhelinnumero. |