# เอกสาร GenderAPI.io V2

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

Canonical HTML: https://www.genderapi.io/th/api-documentation

Last reviewed: 2026-09-30

## ส่งคำขอแรก

ส่งชื่อ ที่อยู่อีเมล หรือชื่อผู้ใช้เพื่อรับผลการคาดการณ์เพศในรูปแบบ JSON ลองเปิด URL ด้านล่างในเบราว์เซอร์โดยไม่ต้องใช้คีย์ API จากนั้นเลือกคู่มือเพื่อเชื่อมต่อแอปพลิเคชันของคุณ

การทดลองใช้ฟรีให้ 10 เครดิตต่อที่อยู่ IP ทุก 24 ชั่วโมง โดยใช้ร่วมกับ V1 ตัวอย่างนี้ใช้เฉพาะชุดข้อมูลและใช้ 1 เครดิตต่อคำขอ รวมถึงทุกครั้งที่รีเฟรชหน้า เมื่อเชื่อมต่อคีย์ API ที่มีอยู่ V1 และ V2 จะใช้ยอดคงเหลือของบัญชีเดียวกัน

```text
https://api.genderapi.io/api/v2/gender?type=name&value=Niran&country=TH&ai_mode=off
```

- [เปิดตัวอย่าง GET (ใช้เครดิตทดลองใช้ 1 เครดิต)](https://api.genderapi.io/api/v2/gender?type=name&value=Niran&country=TH&ai_mode=off)
- [ตั้งค่าคีย์ API](https://www.genderapi.io/th/docs/v2/authentication#environment-setup)
- [ทำความเข้าใจการตอบกลับ JSON](https://www.genderapi.io/th/docs/v2/responses)

## คุณต้องการทำอะไร?

เลือกประเภทข้อมูลนำเข้าเพื่อดูตัวอย่างที่ใช้งานได้จริงใน cURL, JavaScript, Python, PHP, Java, C# และ Go เมื่อพร้อมรับมือกับการตอบกลับจริง ให้ใช้คู่มือเรื่องผลลัพธ์และการหักเครดิต

- [คีย์ API และการทดลองใช้ฟรี](https://www.genderapi.io/th/docs/v2/authentication): เชื่อมต่อคีย์ API หรือทดลองใช้ API ฟรี
- [พารามิเตอร์ของคำขอ](https://www.genderapi.io/th/docs/v2/request-parameters): เลือกฟิลด์ข้อมูลนำเข้า บริบทประเทศ และตัวเลือกของคำขอ
- [SDK อย่างเป็นทางการ](https://www.genderapi.io/th/docs/v2/sdks): ติดตั้งไคลเอนต์อย่างเป็นทางการสำหรับภาษาโปรแกรมของคุณ
- [คาดการณ์เพศจากชื่อ](https://www.genderapi.io/th/docs/v2/gender-from-name): ค้นหาชื่อจริงหรือชื่อ-นามสกุล
- [คาดการณ์เพศจากอีเมล](https://www.genderapi.io/th/docs/v2/gender-from-email): ค้นหาสัญญาณชื่อในที่อยู่อีเมล
- [คาดการณ์เพศจากชื่อผู้ใช้](https://www.genderapi.io/th/docs/v2/gender-from-username): ใช้ชื่อผู้ใช้หรือชื่อเล่นเป็นข้อมูลนำเข้า
- [ค้นหาหลายรายการ (คำขอแบบกลุ่ม)](https://www.genderapi.io/th/docs/v2/batch): ประมวลผลชื่อ อีเมล หรือชื่อผู้ใช้ได้สูงสุด 50 รายการในครั้งเดียว
- [การตรวจสอบหมายเลขโทรศัพท์](https://www.genderapi.io/th/docs/v2/phone-validation): ตรวจสอบและจัดรูปแบบหมายเลขโทรศัพท์
- [อ่านการตอบกลับ](https://www.genderapi.io/th/docs/v2/responses): อ่านผลการคาดการณ์ ค่าความเชื่อมั่น และผลลัพธ์ที่ไม่ทราบ
- [AI และชื่อเล่น](https://www.genderapi.io/th/docs/v2/ai-options): เลือกว่าจะใช้ AI เมื่อใดและจะจัดการชื่อเล่นอย่างไร
- [เครดิตและยอดคงเหลือ](https://www.genderapi.io/th/docs/v2/credits-and-usage): ตรวจสอบยอดคงเหลือและจำนวนเครดิตที่แต่ละคำขอใช้
- [ข้อผิดพลาดและการส่งคำขอซ้ำ](https://www.genderapi.io/th/docs/v2/errors-and-retries): แก้ไขข้อผิดพลาดและตัดสินใจว่าควรส่งคำขอซ้ำเมื่อใด
- [ย้ายจาก V1](https://www.genderapi.io/th/docs/v2/migration): อัปเดตการเชื่อมต่อเดิมโดยใช้คีย์ API เดิม

## ข้อมูลอ้างอิง endpoint

นำ https://api.genderapi.io มาต่อกับพาธแบบสัมบูรณ์ในตารางนี้ เช่น https://api.genderapi.io/api/v2/gender รองรับพารามิเตอร์คิวรีเฉพาะใน GET /gender เท่านั้น ใช้เนื้อหา JSON สำหรับเส้นทาง POST และอย่าส่งฟิลด์ของ V1 เช่น name, email, username หรือ askToAI ในคำขอ V2

| เมธอด | พาธ | วัตถุประสงค์ |
| --- | --- | --- |
| GET | /api/v2 | ความสามารถสาธารณะและขีดจำกัดปัจจุบัน ใช้ฟรี |
| GET | /api/v2/openapi.json | ข้อกำหนด OpenAPI ฉบับหลัก ใช้ฟรี |
| GET | /api/v2/errors | รายการข้อผิดพลาดที่เครื่องอ่านได้ ใช้ฟรี |
| GET | /api/v2/usage | ยอดคงเหลือปัจจุบันของบัญชีหรือการทดลองใช้ ใช้ฟรี |
| GET / POST | /api/v2/gender | ชื่อ ที่อยู่อีเมล หรือชื่อผู้ใช้หนึ่งรายการ |
| POST | /api/v2/gender/batch | ชุดรายการตามลำดับที่ประกอบด้วยชื่อ อีเมล และ/หรือชื่อผู้ใช้ |
| POST | /api/v2/phone/validate | ตรวจสอบและจัดรูปแบบหมายเลขโทรศัพท์ |