Odpowiadać płeć na podstawie do 50 adresów e-mail

Podsumowanie żądania woluminowego

Przetwarzanie maksymalnie 50 adresów e-mail

Wyślijdatatablicę. GenderAPI extrahuje prawdopodobny imię z każdego adresu i zwraca odpowiednią predykcję; Twoja opcjonalnaidupewnia, że korelacja z bazą danych jest deterministyczna.

MethodPOST

Maximum50 e-maili

Authenticationtoken Bearer

Format wynikunames[]

50 e-maili maxExtrakcja imieniaWyniki świadome w zakresie krajów

HDR

Wymagane nagłówki HTTP

Oprawienie żądania w formie masowej

Content-Typeapplication/json

AuthorizationBearer TWOJ_KLUCZ_API

Ciało żądania w formacie JSON

Parametry

Field	Type	Requirement	Description
`data`	object[]	Wymagane	Array zawierający od 1 do 50 rekordów e-maili.
`data[].email`	string	Wymagane	Adres e-mail z którego GenderAPI extrahuje prawdopodobny imię.
`data[].country`	string	Opcjonalne	Kod kraju ISO 3166-1 alpha-2 używany jako kontekst regionalny.
`data[].id`	string \| integer	Opcjonalne	Twoje identyfikatory rekordu, zwrócone bez zmian wraz z odpowiadającym wynikiem.

Zgodność z rekordami

Użyj unikalnegoidDla każdego elementu. GenderAPI zwraca go razem z wynikiem danego elementu, co umożliwia aktualizację odpowiedniego rekordu w bazie danych bez zależności od pozycji w array.

Zawartość żądania

Tworzenie array e-maili

JSON

{
  "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" }
  ]
}

Przykłady kodu

Wyślij żądanie z wieloma adresami e-maili

cURL

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":"james.brown@example.com","country":"US","id":"789"}]}'

JavaScript

const data = [
  { email: "andrea.schmidt@example.com", country: "DE", id: "123" },
  { email: "james.brown@example.com", country: "US", id: "789" }
];
const response = await 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 })
});

Odpowiedź o kodzie 200

Wyodrębnione imiona i przewidywania

JSON

{
  "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": "James", "q": "james.brown@example.com", "gender": "male", "country": "US", "total_names": 45274, "probability": 100, "id": "789" }
  ], "duration": "5ms"
}

Pola odpowiedzi

Field	Type	Description
`status`	boolean	Czy żądanie w dużym zakresie zakończyło się powodzeniem.
`used_credits`	integer	Kredyty zużyte w ramach wszystkich wysłanych e-maili.
`remaining_credits`	integer	Dostępne kredyty po wykonaniu żądania.
`expires`	integer	Czas wygaśnięcia pakietu w formacie UNIX.
`names`	object[]	Uporządkowana kolekcja wyników dla wysłanych e-maili.
`names[].name`	string	Imię wyodrębnione z adresu e-mail.
`names[].q`	string	Oryginalny e-mail wysłany w żądaniu.
`names[].gender`	string \| null	Przewidywana wartość: męski, żeński lub null.
`names[].country`	string	Kod krajowy uwzględniony w tym wyniku.
`names[].total_names`	integer	Liczba próbek wspierających ten wynik.
`names[].probability`	integer	Confiancja przewidywania w procentach.
`names[].id`	string \| integer	Identyfikator wejściowy zwrócony do powiązania z rekordem.
`duration`	string	Całkowity czas przetwarzania serwera.

Zachowuj każdą żądanie w zakresie 50 rekordów

Weryfikuj każdy adres i podziel większe zestawy danych na grupy nie większe niż 50. Sprawdź wydzielonename and probabilityprzed stosowaniem wyniku.

Następny przewodnik

Odpowiadać na płeć na podstawie nazwy użytkownika

Żądanie pojedyncze nazwy użytkownikaWyodrębnij imię z jednej nazwy użytkownika →Żądanie pojedyncze e-mailaUżyj fallbacku AI dla jednego adresu e-mail →