ย้ายการเชื่อมต่อจาก V1 ไป V2
V1 ยังใช้งานได้ ย้ายการเชื่อมต่อแต่ละรายการเมื่อพร้อมโดยใช้คีย์และยอดเครดิตเดิม V2 มีรูปแบบคำขอและการตอบกลับต่างออกไป การเปลี่ยนแค่ URL จึงไม่เพียงพอ
| GenderAPI.io V1 | GenderAPI.io V2 |
|---|---|
| /api, /api/email, /api/username | POST /api/v2/gender พร้อม type เป็น name, email หรือ username และ value |
| /api/name/multi/country, /api/email/multi/country, /api/username/multi/country | POST /api/v2/gender/batch พร้อม items และผสมข้อมูลนำเข้าหลายประเภทได้ |
| /api/phone พร้อม number และ address | POST /api/v2/phone/validate พร้อม number และ country แล้วอ่าน data.valid และ data.possible |
| askToAI | options.ai_mode: fallback โดยคำขอเดี่ยวใช้ fallback เป็นค่าเริ่มต้นอยู่แล้ว |
| forceToGenderize | ฟิลด์ที่ไม่บังคับเดียวกันสำหรับทั้งสามประเภท ค้นหาในชุดข้อมูลก่อน แล้วใช้ AI ที่ตีความชื่อเล่น |
| ฟิลด์การตอบกลับแบบแบน | data สำหรับผลลัพธ์ และ meta สำหรับการเข้าถึงและการหักเครดิต |
| เปอร์เซ็นต์ใน probability | confidence บนสเกล 0–1 พร้อม confidence_kind คะแนนของ AI ไม่ใช่ความน่าจะเป็นที่ปรับเทียบแล้ว |
| total_names | data.sample_count ซึ่งอาจเป็น null |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| รูปแบบข้อผิดพลาดแบบเดิม | สถานะ HTTP พร้อม code และ action ของ Problem Details |
| การส่งคำขอ POST ซ้ำ | การส่งซ้ำแต่ละครั้งเป็นงานใหม่ที่หักเครดิตตามปกติ |
อัปเดตและตรวจสอบไคลเอนต์
ใช้รูปแบบคำขอและการตอบกลับของ V2 สำหรับการเชื่อมต่อที่กำลังย้าย ตรวจสอบ meta.access.mode คงผลลัพธ์ JSON null ไว้ ตรวจสอบข้อผิดพลาดของแต่ละรายการในคำขอแบบกลุ่ม และตรวจสอบการหักเครดิตก่อนส่งคำขอซ้ำ ให้การเชื่อมต่อ V1 ใช้พาธเดิมต่อไปจนกว่าจะอัปเดตไคลเอนต์แล้ว