Sukupuolen määritys sähköpostista – Useita pyyntöjä
Multiple Email -päätepisteen avulla voit analysoida jopa 50 sähköpostiosoitetta yhdellä pyynnöllä. Tämä on hyödyllistä massakäsittelyssä ja suorituskykyisissä integraatioissa. Kaikki parametrit lähetetään POST-pyynnön mukana JSON-muodossa. Sinun täytyy tunnistautua käyttämällä Bearer-tunnusta Authorization-otsikossa.
API poimii todennäköisen etunimen jokaisesta sähköpostiosoitteesta ja määrittää sukupuolen. Voit myös lisätä valinnaisen country
-suodattimen sekä mukautetun id
-kentän jokaiselle riville, jotta voit yhdistää tulokset omaan tietokantaasi.
Pyyntöosoite
POST https://api.genderapi.io/api/email/multi/country
Vaaditut HTTP-otsikot
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
Pyyntörunko-parametrit
Kenttä | Tyyppi | Pakollinen | Kuvaus |
---|---|---|---|
data | Objektitaulukko | Kyllä | Taulukko sähköposteista ja niiden valinnaisista parametreista. Maksimi 50 riviä pyyntöä kohden. |
Merkkijono | Kyllä (jokaisessa objektissa) | Sähköpostiosoite analysoitavaksi. API poimii todennäköisen etunimen. | |
country | Merkkijono | Ei |
Kaksikirjaiminen maakoodi (ISO 3166-1 alpha-2) parantamaan ennusteen tarkkuutta. Esim: TR Turkille.
|
id | Merkkijono tai kokonaisluku | Ei |
Valinnainen tunniste, jolla voit yhdistää tulokset omaan tietokantaan. Sama id palautetaan vastauksessa.
|
Esimerkki pyyntödatasta
{
"data": [
{ "email": "andrea.schmidt@example.com", "country": "DE", "id": "123" },
{ "email": "andrea.rossi@example.it", "country": "IT", "id": "456" },
{ "email": "james.brown@example.com", "country": "US", "id": "789" }
]
}
Esimerkkipyynnöt
cURL-esimerkki
curl -X POST "https://api.genderapi.io/api/email/multi/country" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"data":[{"email":"andrea.schmidt@example.com","country":"DE","id":"123"},{"email":"andrea.rossi@example.it","country":"IT","id":"456"},{"email":"james.brown@example.com","country":"US","id":"789"}]}'
PHP cURL -esimerkki
<?php
$url = "https://api.genderapi.io/api/email/multi/country";
$data = array(
"data" => array(
array(
"email" => "andrea.schmidt@example.com",
"country" => "DE",
"id" => "123"
),
array(
"email" => "andrea.rossi@example.it",
"country" => "IT",
"id" => "456"
),
array(
"email" => "james.brown@example.com",
"country" => "US",
"id" => "789"
)
)
);
$payload = json_encode($data);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
"Content-Type: application/json",
"Authorization: Bearer YOUR_API_KEY"
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
JavaScript fetch -esimerkki
fetch("https://api.genderapi.io/api/email/multi/country", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_KEY"
},
body: JSON.stringify({
data: [
{ email: "andrea.schmidt@example.com", country: "DE", id: "123" },
{ email: "andrea.rossi@example.it", country: "IT", id: "456" },
{ email: "james.brown@example.com", country: "US", id: "789" }
]
})
})
.then(response => response.json())
.then(data => console.log(data));
Python requests -esimerkki
import requests
url = "https://api.genderapi.io/api/email/multi/country"
payload = {
"data": [
{ "email": "andrea.schmidt@example.com", "country": "DE", "id": "123" },
{ "email": "andrea.rossi@example.it", "country": "IT", "id": "456" },
{ "email": "james.brown@example.com", "country": "US", "id": "789" }
]
}
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_KEY"
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())
Esimerkki JSON-vastauksesta
{
"status": true,
"used_credits": 3,
"remaining_credits": 7265,
"expires": 1717069765,
"names": [
{
"name": "Andrea",
"q": "andrea.schmidt@example.com",
"gender": "female",
"country": "DE",
"total_names": 644,
"probability": 88,
"id": "123"
},
{
"name": "Andrea",
"q": "andrea.rossi@example.it",
"gender": "male",
"country": "IT",
"total_names": 13537,
"probability": 98,
"id": "456"
},
{
"name": "James",
"q": "james.brown@example.com",
"gender": "male",
"country": "US",
"total_names": 45274,
"probability": 100,
"id": "789"
}
],
"duration": "5ms"
}
Vasteen kentät
Kenttä | Tyyppi | Kuvaus |
---|---|---|
status | Boolean | Kertoo, onnistuiko pyyntö. |
used_credits | Kokonaisluku | Tähän pyyntöön käytettyjen krediittien määrä. |
remaining_credits | Kokonaisluku | Käyttäjätilillesi jääneet krediitit pyynnön jälkeen. |
expires | Kokonaisluku (timestamp) | Paketin vanhenemispäivä UNIX-aikaleimana. |
names | Objektitaulukko | Vastausten lista jokaiselle sähköpostille. |
names[].name | Merkkijono | Sähköpostista poimittu etunimi. |
names[].q | Merkkijono | Alkuperäinen syöttämäsi sähköposti. |
names[].gender | Enum[String] | Ennustettu sukupuoli: male , female tai null . |
names[].country | Merkkijono | Maa, jota ennusteessa on käytetty. |
names[].total_names | Kokonaisluku | Kuinka monesta nimestä ennuste on laskettu. |
names[].probability | Kokonaisluku | Varmuusprosentti sukupuoliennusteessa. |
names[].id | Merkkijono / Kokonaisluku | Sama id , jonka annoit pyynnössä. Käytetään yhdistämiseen omiin tietueisiisi. |
duration | Merkkijono | Koko pyynnön käsittelyaika (esim. 5ms ). |