API ทำนายเพศจากหลายชื่อ | คำขอหลายรายการ

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

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

ส่งอาร์เรย์ data แล้วรับหนึ่งผลลัพธ์ต่อระเบียน เพิ่ม id จากระบบของคุณเพื่อเชื่อมแต่ละ การทำนายกับระเบียนต้นทาง

วิธีPOST

สูงสุด100 ชื่อ

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

AI เสริมไม่รองรับ

คำขอหลายรายการไม่ใช้การอนุมานด้วย AI

ไม่สามารถใช้ askToAI และ forceToGenderize ได้ สำหรับข้อมูลที่ต้องใช้ AI เสริม ให้ใช้endpoint สำหรับชื่อเดียว

HDR

HTTP header ที่จำเป็น

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

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

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

พารามิเตอร์

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

การใช้บริบทประเทศสำรอง

หากไม่มีผลลัพธ์ในประเทศที่เลือก ระบบจะคืนผลลัพธ์ชื่อจากทั่วโลก ใช้รหัส เช่น TH,JP หรือ US

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

สร้างอาร์เรย์ data

JSON

{
  "data": [
    { "name": "Araya", "country": "TH", "id": "123" },
    { "name": "Haruto", "country": "JP", "id": "456" }
  ]
}

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

ส่งคำขอหลายชื่อ

cURL

curl -X POST "https://api.genderapi.io/api/name/multi/country" \
 -H "Content-Type: application/json" \
 -H "Authorization: Bearer YOUR_API_KEY" \
 -d '{"data":[{"name":"Araya","country":"TH","id":"123"}]}'

JavaScript

const data = [{ name: "Araya", country: "TH", id: "123" }];
await fetch("https://api.genderapi.io/api/name/multi/country", {
 method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" }, body: JSON.stringify({ data })
});

ผลลัพธ์ 200

เชื่อมผลลัพธ์กับระเบียนต้นทาง

JSON

{ "status": true, "used_credits": 2, "remaining_credits": 4998, "expires": 1743659200,
 "names": [{ "name": "araya", "q": "Araya", "gender": "female", "country": "TH", "total_names": 10234, "probability": 98, "id": "123" }], "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	เวลาประมวลผลทั้งหมดของเซิร์ฟเวอร์

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

ตรวจสอบอาร์เรย์ก่อนส่งและเชื่อมระเบียนด้วย id ที่ไม่ซ้ำ แบ่งชุดข้อมูลขนาดใหญ่ออกเป็นชุดละ ไม่เกิน 100 รายการ

คู่มือถัดไป

ทำนายเพศจากอีเมล

คำขออีเมลเดียวแยกชื่อจากอีเมลและวิเคราะห์ →คำขอชื่อเดียวใช้ AI เสริมกับชื่อเดียว →

วิเคราะห์หลายชื่อในคำขอเดียว