การใช้งานและโควตา GenderAPI | ตรวจสอบเครดิตคงเหลือ

ภาพรวมโควตา

ตรวจสอบความจุก่อนเริ่มประมวลผล

ใช้ endpoint ตรวจสอบเครดิตคงเหลือกับระบบมอนิเตอร์ แดชบอร์ดภายใน หรือเวิร์กโฟลว์แบบกลุ่ม โดย endpoint นี้ส่งคืนผลลัพธ์ขนาดเล็กและไม่ทำการค้นหาเพศ

เครดิตคงเหลือ9,443คำขอที่พร้อมใช้งาน

สถานะแพ็กเกจ ใช้งานอยู่อ้างอิงจากตัวอย่างการตอบกลับ

หมดอายุเมื่อ1752651601UNIX timestamp

GET

Endpoint เครดิตคงเหลือ

เรียกดูข้อมูลโควตา

เพิ่ม API key เป็นพารามิเตอร์ query ชื่อ key และส่งคำขอจากฝั่งเซิร์ฟเวอร์เพื่อไม่ให้ข้อมูลรับรองถูกเปิดเผยต่อผู้เข้าชม

https://api.genderapi.io/api/remaining?key=YOUR_API_KEY

cURL

curl "https://api.genderapi.io/api/remaining?key=YOUR_API_KEY"

ความปลอดภัยของข้อมูลรับรอง: อย่าเรียก endpoint นี้โดยตรงจาก JavaScript ในเบราว์เซอร์สาธารณะ ให้เรียกจาก backend, scheduled job หรือ server function ที่ได้รับการป้องกัน

ตัวอย่างการตอบกลับ

ยอดคงเหลือและเวลาหมดอายุ

JSON

{
  "status": true,
  "remaining": 9443,
  "expiresAt": 1752651601
}

ฟิลด์ในการตอบกลับ

ฟิลด์	ชนิดข้อมูล	คำอธิบาย
`status`	boolean	มีค่า `true` เมื่อคำขอสำเร็จและ API key ถูกต้อง
`remaining`	integer	จำนวนเครดิต API ที่พร้อมใช้งานในขณะนั้น
`expiresAt`	integer	เวลาหมดอายุของแพ็กเกจในรูปแบบ UNIX timestamp หน่วยวินาที

แนวทางการปฏิบัติงาน

สร้างระบบติดตามที่แจ้งเตือนก่อนโควตาหมด

แสดงความจุปัจจุบัน

แสดงยอดคงเหลือในแดชบอร์ดภายในสำหรับทีมปฏิบัติการและทีมสนับสนุน

กำหนดเกณฑ์แจ้งเตือน

แจ้งเตือนก่อนยอดคงเหลือถึงศูนย์ เพื่อให้มีเวลาเติมเครดิต

ป้องกันเวิร์กโฟลว์แบบกลุ่ม

เปรียบเทียบเครดิตที่มีอยู่กับจำนวนรายการในงานก่อนเริ่มประมวลผล

ตัวอย่างนโยบายแจ้งเตือน

กำหนดเกณฑ์ให้เหมาะกับปริมาณการใช้งาน แทนการใช้ค่าเดียวกับทุกระบบ

ปกติเหลือมากกว่า 20%
เฝ้าระวังเหลือ 10–20%
วิกฤตเหลือน้อยกว่า 10%

เตรียมรับมือเมื่อโควตาหมด

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

เอกสารถัดไป

จัดการข้อผิดพลาดจาก API

รหัสข้อผิดพลาดสร้างการจัดการข้อผิดพลาดที่คาดการณ์ได้ →ราคาเปรียบเทียบแพ็กเกจเครดิต →

ติดตามการใช้งานและเครดิตคงเหลือ