API ทำนายเพศจากหลายชื่อผู้ใช้

ภาพรวมคำขอหลายรายการ

ประมวลผลได้สูงสุด 50 ชื่อผู้ใช้

ส่งอาร์เรย์ data แล้ว GenderAPI จะแยกสัญญาณชื่อจากแต่ละแฮนเดิลและคืนผลลัพธ์พร้อมid ระเบียนที่เลือกใส่ได้

วิธีPOST

สูงสุด50 ชื่อผู้ใช้

การยืนยันตัวตนBearer token

ตัวเลือก AIไม่รองรับ

ควรตรวจสอบผลลัพธ์ชื่อผู้ใช้หลายรายการอย่างรอบคอบ

แฮนเดิลอาจมีแบรนด์ คำแฟนตาซี หรือคำที่ไม่เกี่ยวข้อง คำขอหลายรายการไม่รองรับ askToAI or forceToGenderize หากต้องการจัดการอินพุตที่ไม่ทั่วไปอย่างรอบคอบยิ่งขึ้น ให้ใช้ คำขอเดียว.

HDR

HTTP header ที่จำเป็น

ยืนยันตัวตนคำขอหลายรายการ

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

เนื้อหาคำขอ JSON

พารามิเตอร์

ฟิลด์	ชนิด	ข้อกำหนด	คำอธิบาย
`data`	object[]	จำเป็น	อาร์เรย์ระเบียนชื่อผู้ใช้ 1–50 รายการ
`data[].username`	string	จำเป็น	ชื่อผู้ใช้หรือแฮนเดิลที่ต้องการวิเคราะห์ รองรับขีดล่างและตัวเลข
`data[].country`	string	ไม่บังคับ	รหัสประเทศ ISO 3166-1 alpha-2 สำหรับบริบทภูมิภาค
`data[].id`	string \| integer	ไม่บังคับ	ID จากระบบของคุณที่ส่งคืนโดยไม่เปลี่ยนแปลงพร้อมผลลัพธ์ที่เกี่ยวข้อง

คำแนะนำอินพุต

ชื่อผู้ใช้ที่ใช้อักษรละตินมักให้สัญญาณชื่อที่ชัดกว่า ใช้ id ที่ไม่ซ้ำและตรวจสอบ nameกับ probability ที่แยกได้ก่อนอัปเดตระเบียน

เพย์โหลดคำขอ

สร้างอาร์เรย์ชื่อผู้ใช้

JSON

{
  "data": [
    { "username": "anna_smith88", "country": "US", "id": "123" },
    { "username": "michael_bauer", "country": "DE", "id": "456" },
    { "username": "giulia_rossi", "country": "IT", "id": "789" }
  ]
}

ตัวอย่างโค้ด

ส่งคำขอหลายชื่อผู้ใช้

cURL

curl -X POST "https://api.genderapi.io/api/username/multi/country" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"data":[{"username":"anna_smith88","country":"US","id":"123"},{"username":"michael_bauer","country":"DE","id":"456"}]}'

JavaScript

const data = [
  { username: "anna_smith88", country: "US", id: "123" },
  { username: "michael_bauer", country: "DE", id: "456" }
];
const response = await fetch("https://api.genderapi.io/api/username/multi/country", {
  method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ data })
});

ผลลัพธ์ 200

ชื่อที่แยกได้และผลการทำนายเพศ

JSON

{
  "status": true, "used_credits": 3, "remaining_credits": 7265, "expires": 1717069765,
  "names": [
    { "name": "Anna", "q": "anna_smith88", "gender": "female", "country": "US", "total_names": 1234, "probability": 92, "id": "123" },
    { "name": "Michael", "q": "michael_bauer", "gender": "male", "country": "DE", "total_names": 5678, "probability": 89, "id": "456" }
  ], "duration": "5ms"
}

ฟิลด์ผลลัพธ์

ฟิลด์	ชนิด	คำอธิบาย
`status`	boolean	ระบุว่าคำขอหลายรายการเสร็จสมบูรณ์หรือไม่
`used_credits`	integer	เครดิตที่ใช้กับชื่อผู้ใช้ทั้งหมดที่ส่ง
`remaining_credits`	integer	เครดิตคงเหลือหลังคำขอ
`expires`	integer	UNIX timestamp ที่แพ็กเกจหมดอายุ
`names`	object[]	อาร์เรย์ผลลัพธ์ของชื่อผู้ใช้ที่ส่ง
`names[].name`	string	ชื่อที่เป็นไปได้ซึ่งแยกจากชื่อผู้ใช้
`names[].q`	string	ชื่อผู้ใช้เดิมที่ส่ง
`names[].gender`	string \| null	ผลการทำนายเป็น male, female หรือ null
`names[].country`	string	รหัสประเทศที่ใช้กับผลลัพธ์
`names[].total_names`	integer	จำนวนระเบียนชื่อที่เป็นพื้นฐานของผลลัพธ์
`names[].probability`	integer	เปอร์เซ็นต์ความเชื่อมั่นของการทำนาย
`names[].id`	string \| integer	ID อินพุตที่ส่งคืนเพื่อเชื่อมระเบียน
`duration`	string	เวลาประมวลผลทั้งหมดของเซิร์ฟเวอร์

จำกัดไม่เกิน 50 ระเบียนต่อคำขอ

แบ่งอินพุตขนาดใหญ่ออกเป็นหลายชุด ชื่อผู้ใช้เป็นสัญญาณทางอ้อม จึงควรตรวจสอบชื่อที่แยกได้และกำหนด เกณฑ์ความน่าจะเป็นที่เหมาะสมก่อนใช้ผลลัพธ์

เอกสารถัดไป

ตรวจสอบและจัดรูปแบบหมายเลขโทรศัพท์

การตรวจสอบหมายเลขโทรศัพท์ดูวิธีตรวจสอบและจัดรูปแบบ →คำขอชื่อผู้ใช้เดียวใช้ตัวเลือก AI กับแฮนเดิลเดียว →

วิเคราะห์หลายชื่อผู้ใช้