Lấy Giới Tính từ Tên Người Dùng - Yêu Cầu Đơn Lẻ
Endpoint Get Gender by Username 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 một tên người dùng hoặc biệt danh. Tất cả các tham số được gửi thông qua 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/username
HTTP Header Bắt Buộc
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
Các Tham Số Trong Body Yêu Cầu
Tham Số |
Kiểu Dữ Liệu |
Bắt Buộc |
Mô Tả |
username |
String |
Có |
Tên người dùng hoặc biệt danh cần phân tích. Có thể là tên tài khoản mạng xã hội, tên hiển thị hoặc bí danh.
Có thể chứa những từ không phải tên thật như các từ fantasy hoặc tên thương hiệu.
|
country |
String |
Không |
Mã quốc gia 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 đặt thành true , API sẽ hỏi mô hình AI để xác định giới tính nếu tên trích xuất được
không có trong cơ sở dữ liệu.
|
forceToGenderize |
Boolean |
Không |
Nếu đặt thành true , API sẽ cố gắng đoán giới tính ngay cả với các username không giống
tên người thật, ví dụ như từ fantasy hoặc biệt danh (ví dụ sparkling_unicorn ).
|
Ví Dụ Yêu Cầu
Ví Dụ cURL
curl -X POST "https://api.genderapi.io/api/username" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"username": "sparkling_unicorn", "country": "US", "askToAI": true, "forceToGenderize": true}'
Ví Dụ PHP cURL
<?php
$url = "https://api.genderapi.io/api/username";
$data = array(
"username" => "sparkling_unicorn",
"country" => "US",
"askToAI" => true,
"forceToGenderize" => 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/username", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_KEY"
},
body: JSON.stringify({
username: "sparkling_unicorn",
country: "US",
askToAI: true,
forceToGenderize: true
})
})
.then(response => response.json())
.then(data => console.log(data));
Ví Dụ Python requests
import requests
url = "https://api.genderapi.io/api/username"
payload = {
"username": "sparkling_unicorn",
"country": "US",
"askToAI": True,
"forceToGenderize": 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": "sparkling_unicorn",
"name": "Sparkling",
"gender": "female",
"country": "US",
"total_names": 9876,
"probability": 92,
"duration": "6ms"
}
Các Trường Trong Phản Hồi
Trường |
Kiểu Dữ Liệu |
Mô Tả |
status |
Boolean |
Cho biết yêu cầu có thành công hay không. |
used_credits |
Integer |
Số credit đã tiêu tốn 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 bạn gửi vào (tức là username bạn đã gửi). |
name |
String |
Tên riêng được trích xuất từ username. |
gender |
Enum[String] |
Giới tính dự đoán. 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 để dự đoán. |
probability |
Integer |
Tỷ lệ phần trăm độ tin cậy của dự đoán giới tính. |
duration |
String |
Thời gian xử lý cho yêu cầu (ví dụ: 6ms ). |