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