Lấy Giới Tính từ Email - Yêu Cầu Đơn
Endpoint Get Gender by Email cho phép bạn xác định giới tính của một người bằng cách phân tích
địa chỉ email của họ. Tất cả các tham số được gửi qua một yêu cầu POST dưới dạng JSON.
Bạn phải xác thực bằng phương thức Bearer token trong header Authorization.
URL Yêu Cầu
POST https://api.genderapi.io/api/email
HTTP Header Bắt Buộc
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
Tham Số Trong Body Yêu Cầu
Tham Số |
Kiểu Dữ Liệu |
Bắt Buộc |
Mô Tả |
email |
String |
Có |
Địa chỉ email cần phân tích. API sẽ trích xuất tên đầu tiên có khả năng cao nhất từ email trước khi xác định giới tính.
|
country |
String |
Không |
Mã quốc gia gồm hai ký tự (ISO 3166-1 alpha-2) để tăng độ chính xác của dự đoán.
Ví dụ: TR cho Thổ Nhĩ Kỳ.
|
askToAI |
Boolean |
Không |
Nếu được đặt thành true , API sẽ yêu cầu một mô hình AI xác định giới tính nếu tên trích xuất không tìm thấy trong cơ sở dữ liệu.
|
Ví Dụ Yêu Cầu
Ví Dụ cURL
curl -X POST "https://api.genderapi.io/api/email" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"email": "michael.smith@example.com", "country": "US", "askToAI": true}'
Ví Dụ PHP cURL
<?php
$url = "https://api.genderapi.io/api/email";
$data = array(
"email" => "michael.smith@example.com",
"country" => "US",
"askToAI" => true
);
$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;
?>
Ví Dụ JavaScript fetch
fetch("https://api.genderapi.io/api/email", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_KEY"
},
body: JSON.stringify({
email: "michael.smith@example.com",
country: "US",
askToAI: true
})
})
.then(response => response.json())
.then(data => console.log(data));
Ví Dụ Python requests
import requests
url = "https://api.genderapi.io/api/email"
payload = {
"email": "michael.smith@example.com",
"country": "US",
"askToAI": True
}
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_KEY"
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())
Ví Dụ JSON Phản Hồi
{
"status": true,
"used_credits": 1,
"remaining_credits": 4999,
"expires": 1743659200,
"q": "michael.smith@example.com",
"name": "Michael",
"gender": "male",
"country": "US",
"total_names": 10345,
"probability": 97,
"duration": "5ms"
}
Các Trường Trong Phản Hồi
Trường |
Kiểu Dữ Liệu |
Diễn Giải |
status |
Boolean |
Cho biết yêu cầu có thành công hay không. |
used_credits |
Integer |
Số credit đã sử dụng cho yêu cầu này. |
remaining_credits |
Integer |
Số credit còn lại trong tài khoản sau yêu cầu này. |
expires |
Integer (timestamp) |
Ngày hết hạn gói dịch vụ dưới dạng UNIX timestamp. |
q |
String |
Truy vấn đầu vào của bạn (email đã gửi). |
name |
String |
Tên đầu tiên được trích xuất từ địa chỉ email. |
gender |
Enum[String] |
Giới tính được dự đoán. Các giá trị có thể là: male , female , hoặc null . |
country |
String |
Mã quốc gia được xem xét trong quá trình dự đoán. |
total_names |
Integer |
Số lượng mẫu tên được sử dụng cho dự đoán này. |
probability |
Integer |
Tỷ lệ phần trăm độ tin cậy cho dự đoán giới tính. |
duration |
String |
Thời gian xử lý yêu cầu (ví dụ: 5ms ). |