การใช้งานพื้นฐาน
ส่งคำขอ Gender API ครั้งแรก
ส่งข้อมูลหนึ่งค่าเพื่อรับเพศที่ทำนาย ค่าความเชื่อมั่น ประเทศ และข้อมูลการใช้เครดิต เริ่มจาก endpoint สำหรับชื่อ หรือใช้ endpoint เฉพาะเมื่อข้อมูลของคุณเป็นอีเมลหรือชื่อผู้ใช้
เพิ่ม API key ผ่านพารามิเตอร์ key เก็บ production key ไว้บนเซิร์ฟเวอร์อย่างปลอดภัย และอย่าเปิดเผยในโค้ดฝั่งเบราว์เซอร์หรือ repository สาธารณะ
ใช้สัญญา GenderAPI ล่าสุดในรูปแบบ OpenAPI, Swagger หรือ Postman
ทำนายเพศจากชื่อ
ชื่อหรือชื่อเต็ม
ใช้ endpoint หลักเมื่อข้อมูลนำเข้าเป็นชื่อหรือชื่อเต็ม
https://api.genderapi.io/apicurl "https://api.genderapi.io/api?name=Anan&country=TH&key=YOUR_API_KEY"พารามิเตอร์เสริม
| พารามิเตอร์ | ชนิดข้อมูล | คำอธิบาย |
|---|---|---|
country | string | รหัสประเทศสองตัวอักษร เช่น TH หรือ US |
askToAI | boolean | เมื่อเป็น true ให้ AI ช่วยวิเคราะห์หากไม่พบชื่อในฐานข้อมูล |
forceToGenderize | boolean | พยายามทำนายข้อมูลที่ไม่เหมือนชื่อบุคคลหรือมีรูปแบบผิดปกติ |
ทำนายเพศจากอีเมล
ที่อยู่อีเมล
Email endpoint จะแยกชื่อจากที่อยู่อีเมลก่อนทำนายเพศ
https://api.genderapi.io/api/emailcurl "https://api.genderapi.io/api/email?email=anan.s%40example.com&country=TH&askToAI=true&key=YOUR_API_KEY"forceToGenderizeทำนายเพศจากชื่อผู้ใช้
ชื่อผู้ใช้บนโซเชียลมีเดีย
ใช้ endpoint นี้กับ username, handle หรือชื่อเล่นที่มีชื่อบุคคลซึ่งระบุได้
https://api.genderapi.io/api/usernamecurl "https://api.genderapi.io/api/username?username=anan_s&country=TH&askToAI=true&forceToGenderize=true&key=YOUR_API_KEY"ผลลัพธ์ JSON
ทำความเข้าใจโครงสร้างผลลัพธ์ GenderAPI
ทั้งสาม endpoint ใช้โครงสร้างผลลัพธ์หลักแบบเดียวกัน
{
"status": true,
"used_credits": 1,
"remaining_credits": 4999,
"expires": 1743659200,
"q": "Anan",
"name": "anan",
"gender": "male",
"country": "TH",
"total_names": 325,
"probability": 98,
"duration": "4ms"
}ฟิลด์ผลลัพธ์
| ฟิลด์ | ชนิดข้อมูล | คำอธิบาย |
|---|---|---|
status | boolean | ระบุว่าคำขอประมวลผลสำเร็จหรือไม่ |
used_credits | integer | จำนวนเครดิตที่ใช้กับคำขอนี้ |
remaining_credits | integer | จำนวนเครดิตคงเหลือหลังประมวลผลคำขอ |
expires | integer | เวลา UNIX timestamp ที่แพ็กเกจหมดอายุ |
q | string | ชื่อ อีเมล หรือชื่อผู้ใช้ต้นฉบับที่ส่งมา |
name | string | ชื่อที่ปรับรูปแบบหรือแยกออกจากข้อมูลนำเข้า |
gender | string | ผลการทำนาย: male, female หรือ "null" |
country | string | รหัสประเทศ ISO 3166-1 alpha-2 ที่เป็นไปได้มากที่สุด |
total_names | integer | จำนวนระเบียนชื่อที่ใช้ประกอบการทำนาย |
probability | integer | ระดับความเชื่อมั่นของการทำนายเป็นเปอร์เซ็นต์ |
duration | string | เวลาที่เซิร์ฟเวอร์ใช้ประมวลผลคำขอ |
เข้ารหัส URL ของข้อมูลนำเข้าทุกครั้ง
HTTP client ต้องเข้ารหัสช่องว่างและอักขระพิเศษ เช่น ใช้ anan%20siri แทนช่องว่างปกติ
ขั้นตอนถัดไป