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.
https://api.genderapi.io/api/v2/gender?type=name&value=Emilia&country=FI&ai_mode=offMitä 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.
Aloittaminen
Pyyntöjen lähettäminen
- Sukupuolen arviointi nimestä Hae etunimellä tai koko nimellä.
- Sukupuolen arviointi sähköpostista Etsi nimisignaali sähköpostiosoitteesta.
- Sukupuolen arviointi käyttäjänimestä Käytä syötteenä käyttäjänimeä tai lempinimeä.
- Eräpyynnöt (batch) Käsittele enintään 50 nimeä, sähköpostiosoitetta tai käyttäjänimeä kerralla.
- Puhelinnumeron tarkistus Tarkista ja muotoile puhelinnumero.
Tulokset ja kustannukset
- Vastauksen tulkinta Tulkitse ennusteet, luottamusarvot ja tuntemattomat tulokset.
- Tekoäly ja lempinimet Valitse, milloin tekoälyä käytetään ja miten lempinimiä käsitellään.
- Krediitit ja saldo Tarkista saldosi ja kunkin pyynnön hinta.
- Virheet ja uudelleenyritykset Ratkaise virheet ja päätä, milloin pyyntö kannattaa yrittää uudelleen.
Siirtyminen V1:stä
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. |