Lấy Giới Tính từ Tên - Yêu Cầu Đơn
Endpoint Lấy Giới Tính từ Tên cho phép bạn xác định giới tính từ một tên riêng lẻ. Tất cả các tham số được gửi 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
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ả |
---|---|---|---|
name | String | Có | Tên mà bạn muốn phân tích. Phải là một từ duy nhất, không chứa danh xưng hoặc tiền tố. |
country | String | Không |
Mã quốc gia gồm hai chữ cái (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 là true , API sẽ hỏi mô hình AI để xác định giới tính nếu không tìm thấy tên trong cơ sở dữ liệu.
|
forceToGenderize | Boolean | Không |
Nếu đặt là true , API sẽ cố gắng đoán giới tính ngay cả với các giá trị không phải tên người thật,
như biệt danh hoặc các cụm từ tưởng tượng (ví dụ: sparkling unicorn ).
|
Ví Dụ Yêu Cầu
Ví Dụ cURL
curl -X POST "https://api.genderapi.io/api" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"name": "Alice", "country": "US", "askToAI": true, "forceToGenderize": true}'
Ví Dụ PHP cURL
<?php
$url = "https://api.genderapi.io/api";
$data = array(
"name" => "Alice",
"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", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_KEY"
},
body: JSON.stringify({
name: "Alice",
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"
payload = {
"name": "Alice",
"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": "Alice",
"name": "Alice",
"gender": "female",
"country": "US",
"total_names": 10234,
"probability": 98,
"duration": "4ms"
}
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 đã 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 bạn gửi (tên bạn nhập vào). |
name | String | Tên được phân tích hoặc trích xuất. |
gender | Enum[String] | Giới tính được dự đoán. Giá trị có thể: 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ụ: 4ms ). |
Cảnh báo:
Luôn đảm bảo rằng các giá trị đầu vào như tên không chứa ký tự không mong muốn.
Nếu bạn định sử dụng các ký tự đặc biệt hoặc khoảng trắng, hãy chắc chắn mã hóa JSON đúng cách để tránh lỗi.