# ย้ายจาก GenderAPI v1 เป็น v2

> ย้ายการรวม GenderAPI จาก v1 ไปยัง v2 โดยใช้คีย์และความสมดุล API เดียวกัน ฟิลด์คำขอแมป เส้นทางแบทช์ การตอบสนอง ข้อผิดพลาด และพฤติกรรมการลองใหม่

Canonical HTML: https://www.genderapi.io/th/docs/v2/migration

Last reviewed: 2026-09-25

## ย้ายการรวมจาก 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 ลองอีกครั้ง | การลองใหม่แต่ละครั้งถือเป็นการดำเนินการใหม่โดยมีการเรียกเก็บเงินตามปกติ |

- [อ่านข้อมูลอ้างอิง v1](https://www.genderapi.io/th/api-documentation/v1)
- [ใช้สัญญา v2 OpenAPI](https://api.genderapi.io/api/v2/openapi.json)

## อัปเดตและยืนยันไคลเอ็นต์ของคุณ

ใช้สัญญาคำขอและการตอบสนอง v2 สำหรับการผสานรวมที่คุณกำลังย้าย ตรวจสอบ meta.access.mode รักษาผลลัพธ์ JSON null ตรวจสอบข้อผิดพลาดแบตช์ต่อรายการ และตรวจสอบการเรียกเก็บเงินก่อนลองอีกครั้ง เก็บการผสานรวม v1 ไว้บนเส้นทางที่มีอยู่จนกว่าไคลเอ็นต์จะได้รับการอัปเดต

- [เริ่มต้นด้วยการตรวจสอบสิทธิ์](https://www.genderapi.io/th/docs/v2/authentication)
- [อ่านการตอบสนอง v2](https://www.genderapi.io/th/docs/v2/responses)
- [จัดการลองใหม่](https://www.genderapi.io/th/docs/v2/errors-and-retries)