เลือกวิธีเชื่อมต่อ Pabbly Connect ที่ตรงกับข้อกำหนดของ API
การตั้งค่า HTTP ในคู่มือนี้เรียก GenderAPI.io V2 ที่ https://api.genderapi.io/api/v2/gender ส่ง type และ value ในเนื้อหา JSON ผลการคาดการณ์อยู่ใน data ส่วนข้อมูลคำขอและการหักเครดิตอยู่ใน meta ตัวเชื่อมต่อในตัวมีข้อกำหนดของตัวเองตามที่อธิบายไว้ด้านล่าง
แค็ตตาล็อกสาธารณะของ Pabbly มีแอปชื่อ Gender API แต่หน้ารายการที่ตรวจทานไม่ได้ระบุโดเมนของผู้ให้บริการ เวอร์ชันของ endpoint หรือสคีมาการตอบกลับฉบับเต็ม ชื่อเพียงอย่างเดียวยืนยันไม่ได้ว่าเป็น GenderAPI.io ก่อนเลือกแอ็กชันในตัว ให้ตรวจสอบผู้ให้บริการและฟิลด์จริง
หากต้องการใช้ endpoint ของ V2 อย่างชัดเจน ให้ใช้ความสามารถคำขอ API แบบกำหนดเองของ API by Pabbly การตั้งค่านี้อธิบายเฉพาะคำขอ HTTP ดังกล่าว และไม่ได้อ้างว่าตัวเชื่อมต่อในตัวย้ายไปใช้ V2 แล้ว
เตรียมบัญชีและเรคคอร์ดต้นทาง
ตัวอย่างนี้เพิ่มข้อมูลให้เรคคอร์ดใน Shopify จากชื่อ คุณต้องมีสิทธิ์เข้าถึงแอปต้นทางและแอปปลายทาง คีย์ API ของบัญชี GenderAPI.io และฟีเจอร์ของแพลตฟอร์มที่ใช้สร้างแอ็กชัน HTTP ได้ คู่มือนี้ไม่มีข้อมูลเข้าสู่ระบบที่ใช้งานได้จริงหรือบัญชีที่เชื่อมต่อไว้
V1 และ V2 ใช้คีย์ API ของบัญชีและยอดคงเหลือเดียวกัน ก่อนตั้งค่าคำขอที่มีการหักเครดิต ให้ตรวจสอบคีย์ด้วย GET /api/v2/usage และตรวจสอบว่าค่า meta.access.mode ในการตอบกลับของ endpoint นี้เป็น api_key หากไม่มีคีย์หรือระบบไม่รู้จักคีย์ อาจใช้การทดลองใช้ตาม IP ที่ใช้ร่วมกันแทน ระบบอัตโนมัติที่ใช้งานจริงไม่ควรพึ่งพาการทดลองใช้ตาม IP โดยไม่รู้ตัว
ปิดเวิร์กโฟลว์ไว้ระหว่างการตั้งค่า คำขอการคาดการณ์เพื่อทดสอบก็ถูกหักเครดิตตามปกติ คู่มือนี้ตรวจทานโดยอ้างอิงเอกสารสาธารณะและข้อกำหนดของ V2 การเผยแพร่ครั้งนี้ไม่ได้รันเวิร์กโฟลว์ที่ยืนยันตัวตนแล้วตั้งแต่ต้นจนจบบนแพลตฟอร์มใด
ตั้งค่าคำขอ GenderAPI.io V2 ใน Pabbly Connect
- เลือกทริกเกอร์ Shopify ที่ตรงกับเหตุการณ์ลูกค้าที่ต้องการ และดึงเรคคอร์ดทดสอบที่เป็นตัวแทนของข้อมูลจริงหนึ่งรายการ เก็บ ID ลูกค้าไว้ และแมปฟิลด์ชื่อต้น (first name) ที่มีอยู่ หากชื่อว่าง ให้ข้ามไป อย่าใช้เรคคอร์ดลูกค้าทั้งหมดแทน
- เพิ่ม API by Pabbly และเลือก Custom Request เลือก POST และ URL ของ V2 ด้านล่าง กำหนดการยืนยันตัวตนแบบ Bearer token ด้วยคีย์ GenderAPI ของคุณ หรือกำหนดส่วนหัว Authorization ที่มีค่าเต็มเป็น Bearer YOUR_API_KEY อย่ากำหนดทั้งสองวิธีพร้อมกัน
- ตั้ง Content-Type เป็น application/json ทั้งนี้ Custom Request มีฟิลด์ "Data" สำหรับเนื้อหาคำขอ JSON สร้างออบเจ็กต์ด้วย type = name, ออบเจ็กต์ options ที่มี ai_mode = off และ value = ชื่อต้นที่แมปไว้ ส่วนหัว Content-Type บอกเพียงรูปแบบของเนื้อหาที่ส่ง และไม่ได้แปลงฟิลด์แบบฟอร์มเป็นออบเจ็กต์ JSON
- คง options ไว้เป็นออบเจ็กต์ที่ซ้อนอยู่ หากแอ็กชันที่เลือกรองรับเฉพาะ JSON ดิบ ให้ตรวจสอบว่าเครื่องหมายคำพูด แบ็กสแลช และการขึ้นบรรทัดใหม่ในค่าที่แมปไว้ได้รับการ escape อย่างถูกต้องตามกฎ JSON อย่าแทรกข้อความลูกค้าที่ยังไม่ได้ escape ให้ใช้ขั้นตอนสร้าง JSON ที่รองรับ
| การตั้งค่า HTTP | ค่า | วัตถุประสงค์ |
|---|---|---|
Method | POST | ส่งคำขอการคาดการณ์ 1 รายการ |
URL | https://api.genderapi.io/api/v2/gender | endpoint ของ GenderAPI.io V2 สำหรับการคาดการณ์ทีละรายการ |
Authorization | Bearer YOUR_API_KEY | แทนที่ค่าตัวยึดตำแหน่งนี้ในการตั้งค่าการยืนยันตัวตนหรือส่วนหัวของแพลตฟอร์ม |
Content-Type | application/json | ส่งออบเจ็กต์ที่มีออบเจ็กต์ options ซ้อนอยู่ ไม่ใช่ฟิลด์ของฟอร์ม |
options.ai_mode | off | การทดสอบครั้งแรกแบบใช้ชุดข้อมูลเท่านั้นโดยตั้งใจ ผลลัพธ์ที่ไม่ทราบก็ยังหักเครดิตตามปกติ 1 เครดิต |
ตรวจสอบเนื้อหาคำขอ JSON ก่อนส่ง
ตัวอย่างนี้แสดงเพียงข้อมูลนำเข้าแบบคงที่ ไม่ใช่ผลลัพธ์ที่คาดหวัง ตรวจสอบโครงสร้างคำขอก่อน จากนั้นแทน value ด้วยฟิลด์ต้นทางที่แมปไว้โดยแปลงเป็น JSON อย่างถูกต้อง อย่าวางนิพจน์การแมปของแพลตฟอร์มลงใน API เป็นข้อความตามตัวอักษร
เมื่อส่งข้อมูลนำเข้าประเภทอื่น ให้ตั้ง type เป็น name, email หรือ username และระบุค่าที่ตรงกันใน value เพิ่ม country เฉพาะเมื่อมีบริบทประเทศที่เชื่อถือได้ ฟิลด์นี้ไม่บังคับ และไม่ได้ใช้ค้นหาว่าบุคคลอาศัยอยู่ในประเทศใด
{
"type": "name",
"value": "Alice",
"options": {
"ai_mode": "off"
}
}ตรวจสอบขั้นตอน HTTP ก่อนเปิดการอัปเดต
ตรวจสอบเนื้อหาการตอบกลับที่ดึงมา และตรวจสอบว่าขั้นตอนถัดไปอ่านเนื้อหาของ V2 ไม่ใช่ฟิลด์สถานะการส่งข้อมูล Pabbly อาจแสดงคีย์ของการตอบกลับให้ใช้แมปในขั้นตอนถัดไป ให้ตรวจสอบเส้นทางจริงในเวิร์กโฟลว์ของคุณ
ระหว่างตั้งค่าโฟลว์ ให้รันเฉพาะแอ็กชันทดสอบที่เลือก การทดสอบที่ส่งคำขออาจใช้เครดิต GenderAPI และงาน (task) ของแพลตฟอร์มแม้ยังไม่ได้เปิดใช้เวิร์กโฟลว์
แยกจัดการผลลัพธ์ identified ผลลัพธ์ที่ไม่ทราบ และความล้มเหลว
แยกวิเคราะห์เนื้อหาการตอบกลับก่อนเลือกการอัปเดตในระบบปลายทาง เส้นทาง JSON ด้านล่างอ้างอิงเนื้อหาการตอบกลับของ V2 แพลตฟอร์มอาจห่อหรือทำให้เนื้อหาแบนราบ ยืนยันโครงสร้างที่ส่งคืนจริงด้วยการทดสอบที่ตั้งใจรัน และเชื่อมผลลัพธ์ไว้กับ ID ของเรคคอร์ดต้นทาง
ผลการคาดการณ์ไม่ได้ยืนยันอัตลักษณ์ของบุคคลหรือเพศที่บุคคลระบุด้วยตนเอง จัดเก็บแยกจากข้อมูลที่บุคคลนั้นให้ไว้ กำหนดเกณฑ์การยอมรับจากข้อมูลที่เป็นตัวแทนของกรณีการใช้งานของคุณ และประเมินค่าความเชื่อมั่นของชุดข้อมูลและของ AI แยกกัน
| รายการที่ตรวจสอบ | ค่าหรือประเภทที่คาดหวัง | การตัดสินใจในเวิร์กโฟลว์ |
|---|---|---|
meta.access.mode | api_key สำหรับเวิร์กโฟลว์นี้ที่ใช้บัญชี | หากค่าเป็น ip_trial ให้หยุดเวิร์กโฟลว์และแก้ไขคีย์ การตอบกลับที่สำเร็จจากการทดลองใช้ตาม IP ไม่ได้พิสูจน์การยืนยันตัวตนของบัญชี และอาจใช้เครดิตของการทดลองใช้ตาม IP ไปแล้ว |
meta.usage.billing_status | confirmed หรือ unconfirmed | หากค่าเป็น unconfirmed ให้เก็บ ID คำขอไว้ และกระทบยอดการหักเครดิตก่อนส่งคำขอซ้ำหรือดำเนินการต่อ |
data.result_status / data.gender | identified พร้อม male หรือ female / unknown พร้อม null | ส่งผลลัพธ์ identified ที่ยอมรับไปยังฟิลด์แยกสำหรับข้อมูลที่ได้จากการคาดการณ์ คงผลลัพธ์ที่ไม่ทราบไว้ตามเดิมโดยไม่กำหนดหมวดหมู่เริ่มต้น |
data.confidence / data.confidence_kind | ตัวเลขตั้งแต่ 0 ถึง 1 หรือ null / ชนิดของหลักฐานหรือ null | ตีความ observed_frequency และ model_reported แยกกัน ทั้งสองค่าไม่ได้รับประกันความแม่นยำโดยรวม |
data.source / data.sample_count | dataset, ai หรือ none / จำนวนเต็มหรือ null | จัดเก็บวิธีที่ได้ผลการคาดการณ์มา AI ไม่มีจำนวนตัวอย่างที่จัดเก็บไว้ และจำนวนตัวอย่างของชุดข้อมูลไม่ใช่ตัวชี้วัดความแม่นยำของผลิตภัณฑ์ |
meta.request_id / meta.usage | ค่าอ้างอิงคำขอ / ออบเจ็กต์การใช้งาน | จัดเก็บทั้งสองค่าไว้คู่กับเรคคอร์ดและผลลัพธ์ของเวิร์กโฟลว์ อย่าบันทึกคีย์ API และข้อมูลส่วนบุคคลที่ไม่จำเป็นลงในล็อกทั่วไป |
ความล้มเหลว HTTP / ไม่มีการตอบกลับ | Problem Details หรือไม่มีการตอบกลับที่สมบูรณ์ | หยุดการอัปเดตไว้ก่อน และตรวจสอบข้อผิดพลาดและสถานะการหักเครดิต การหมดเวลาไม่ได้หมายความว่าเซิร์ฟเวอร์ไม่ได้ทำงานใดเลย |
อัปเดตเฉพาะเรคคอร์ดที่ตรงกันใน Shopify
เก็บ ID ลูกค้า Shopify ที่ได้จากทริกเกอร์ไว้ ส่งผลลัพธ์ identified ที่ยืนยันแล้วไปยังฟิลด์ลูกค้าที่วางแผนไว้หรือจัดการตามนโยบายแท็ก คงผลลัพธ์ที่ไม่ทราบไว้เป็น unknown และอย่าเปลี่ยนชื่อเดิมที่ลูกค้าให้ไว้ จัดเก็บ source และ confidence_kind ไว้กับผลการคาดการณ์ทุกรายการที่ยอมรับ
ทดสอบผลลัพธ์ identified ผลลัพธ์ที่ไม่ทราบ และเส้นทางข้อผิดพลาดแยกกันก่อนเปิดการอัปเดต การใช้การตอบกลับตัวอย่างที่สร้างขึ้นช่วยให้ตรวจสอบเงื่อนไขของแต่ละเส้นทางได้โดยไม่ต้องส่งคำขอการคาดการณ์ใหม่ การอัปเดตในแอปปลายทางต้องเป็นไปตามผลการตรวจสอบด้านบน และต้องไม่เขียนทับฟิลด์หรือแท็กที่ไม่เกี่ยวข้อง
ควบคุมการส่งคำขอซ้ำและการหักเครดิตซ้ำ
Pabbly ระบุในเอกสารถึง Auto Re-execution และตัวเลือกการรันซ้ำด้วยตนเองสำหรับขั้นตอนที่ล้มเหลวหรือถูกข้าม หรือทั้งเวิร์กโฟลว์ ไม่ว่าจะใช้ตัวเลือกใด ให้ตรวจสอบก่อนว่าจะมีอะไรถูกรัน การรันทั้งเวิร์กโฟลว์ซ้ำอาจทำให้คำขอ GenderAPI ที่เสร็จแล้วถูกส่งซ้ำ หากทำได้ ให้กู้คืนความล้มเหลวของ Shopify ที่เกิดภายหลังด้วยการตอบกลับที่บันทึกไว้
คำขอใหม่แต่ละครั้งที่ส่งไปยัง GenderAPI เป็นงานแยกกัน ใช้ ID ต้นทางและสถานะการประมวลผลที่บันทึกไว้ก่อนส่ง เพื่อตัดรายการซ้ำของเหตุการณ์ต้นทางที่เกิดซ้ำในเวิร์กโฟลว์ ID ของเรคคอร์ดต้นทางไม่ใช่คีย์ที่ป้องกันคำขอซ้ำฝั่งเซิร์ฟเวอร์
ผลลัพธ์ที่ไม่ทราบที่สำเร็จเป็นผลลัพธ์ที่หักเครดิตแล้ว เมื่อเกิดการหมดเวลาหรือได้รับการตอบกลับไม่ครบ อาจไม่ทราบทั้งผลลัพธ์และการหักเครดิต เก็บค่าอ้างอิงคำขอไว้หากมี และตรวจสอบประวัติการหักเครดิตก่อนส่งคำขอซ้ำ หากการตอบกลับเรื่องขีดจำกัดคำขอมีส่วนหัว Retry-After ให้ทำตามค่านั้น
เลือกว่าจะใช้ AI เมื่อใด
forceToGenderize เป็นตัวเลือกที่ไม่บังคับสำหรับชื่อ ที่อยู่อีเมล และชื่อผู้ใช้ เมื่อเปิดใช้ ให้ละ ai_mode หรือใช้ fallback เพราะ off และ always ขัดแย้งกับตัวเลือกนี้และจะส่งคืน 422 ยอดคงเหลือเริ่มต้นที่เป็นบวกก็เพียงพอสำหรับเริ่มคำขอ แม้การหักเครดิตครั้งสุดท้ายจะทำให้ยอดคงเหลือต่ำกว่าศูนย์
โหมดชื่อเล่นอาจส่งคืนเพศพร้อม name: null และอาจส่งคืนผลลัพธ์ที่ไม่ทราบได้เช่นกัน ทั้ง AI สำรองแบบปกติและการคาดการณ์จากชื่อเล่นไม่รับประกันคำตอบที่ถูกต้องหรือไม่เป็น null
| ตัวเลือกของคำขอ | การทำงาน | เครดิตสำหรับการค้นหาที่สำเร็จ |
|---|---|---|
| options.ai_mode: off | ใช้เฉพาะชุดข้อมูล | 1 รวมถึงผลลัพธ์ที่ไม่ทราบ |
| options.ai_mode: fallback | ค้นหาในชุดข้อมูลก่อน แล้วใช้ AI แบบปกติเมื่อไม่ได้ผลเป็นเพศ เป็นค่าเริ่มต้นของคำขอเดี่ยว | รวม 1 รวมถึง AI สำรอง |
| options.ai_mode: always | ใช้ AI โดยตรง | 2 |
| forceToGenderize: true | ค้นหาในชุดข้อมูลก่อน แล้วให้ AI ตีความชื่อเล่นหรือนามแฝงของบุคคลได้แม้ไม่มีชื่อจริง | 1 เมื่อชุดข้อมูลระบุเพศได้ หรือรวม 2 หากใช้ AI |
ตรวจสอบเวิร์กโฟลว์ก่อนเพิ่มปริมาณงาน
- ตรวจสอบ JSON ที่แปลงแล้วจริง เส้นทางผลลัพธ์ที่แยกวิเคราะห์แล้ว การเข้าถึงด้วยคีย์ API และการหักเครดิตที่ยืนยันแล้วด้วยการทดสอบที่ตั้งใจรัน หากทำได้ ให้ทดสอบการจัดการผลลัพธ์ที่ไม่ทราบและความล้มเหลวด้วยการตอบกลับตัวอย่าง
- ตรวจสอบว่าขั้นตอนใดของเวิร์กโฟลว์ส่งคำขอซ้ำ และฟิลด์ใดของลูกค้าจะถูกเปลี่ยน เก็บ ID ของเรคคอร์ดต้นทาง การตอบกลับที่เสร็จสมบูรณ์ และค่าอ้างอิงคำขอไว้ เพื่อที่หากระบบปลายทางล้มเหลวในภายหลังจะไม่ต้องส่งคำขอใหม่
- เริ่มจากเปิดใช้การรันขนาดเล็กที่ควบคุมได้ และตรวจสอบเรคคอร์ดและเครดิตก่อนเพิ่มการประมวลผลพร้อมกัน เครดิตของ GenderAPI แยกจากค่าใช้จ่ายงาน (task) หรือการดำเนินการที่แพลตฟอร์มอัตโนมัติเรียกเก็บ
- สำหรับคำขอแบบกลุ่ม ให้ใช้ POST /api/v2/gender/batch การเข้าถึงด้วยคีย์ API ส่งได้สูงสุด 50 รายการ ส่วนการทดลองใช้ตาม IP ส่งได้สูงสุด 10 รายการ อาร์เรย์ items ผสมชื่อ ที่อยู่อีเมล และชื่อผู้ใช้ได้ กำหนดตัวเลือกที่ชัดเจนและ ID ที่ไม่ซ้ำกันให้ทุกรายการ ตรวจสอบทุกผลลัพธ์ การตอบกลับ HTTP 200 อาจมีรายการที่ล้มเหลวอยู่ด้วย ต้องตรวจสอบแยกต่างหากว่าตัวเชื่อมต่อในตัวรองรับคำขอแบบกลุ่มหรือไม่
คำถามที่พบบ่อย
ใช้ฟิลด์แบบฟอร์มแบบแบนราบ options.ai_mode ใน Pabbly ได้หรือไม่?
เนื้อหาคำขอ POST ของ V2 ต้องมีออบเจ็กต์ JSON options จุดในป้ายกำกับฟิลด์ไม่ได้พิสูจน์ว่าแพลตฟอร์มจะซ้อนฟิลด์นั้น ตรวจสอบเนื้อหาที่แปลงแล้ว และยืนยันว่าตรงกับตัวอย่างก่อนส่งคำขอ
ตัวอย่างที่เรียก HTTP โดยตรงใช้ AI หรือไม่?
เนื้อหาคำขอแรกตั้ง options.ai_mode เป็น off หากต้องการใช้ AI สำรองแบบปกติ ให้ตั้งใจเปลี่ยนค่าเป็น fallback (รวม 1 เครดิต) หากต้องการใช้ AI โดยตรง ให้เปลี่ยนเป็น always (2 เครดิต) forceToGenderize ค้นหาในชุดข้อมูลก่อน ใช้ 1 เครดิตเมื่อได้ผลจากชุดข้อมูล หรือรวม 2 เครดิตเมื่อใช้ AI
ผลลัพธ์ที่ไม่ทราบไม่เสียเครดิต และส่งคำขอซ้ำโดยอัตโนมัติได้อย่างปลอดภัยหรือไม่?
ไม่ ผลลัพธ์ที่ไม่ทราบซึ่งดำเนินการสำเร็จเป็นผลลัพธ์ที่เสร็จสมบูรณ์และถูกหักเครดิต การส่งคำขอซ้ำเป็นงานใหม่ หากเกิดข้อผิดพลาดในการส่งหรือยังไม่ได้ยืนยันการหักเครดิต ให้ตรวจสอบข้อมูลการใช้งานที่ส่งคืนและค่าอ้างอิงคำขอก่อนตัดสินใจส่งอีกครั้ง
เวิร์กโฟลว์นี้ได้รันในบัญชีที่เชื่อมต่อแล้วหรือไม่?
ไม่ คู่มือการตั้งค่าของแต่ละแพลตฟอร์มตรวจทานโดยอ้างอิงเอกสารสาธารณะเมื่อ 26 กันยายน 2026 คำอธิบายคำขอและการตอบกลับของ GenderAPI.io V2 ตรวจทานเมื่อ 27 กันยายน 2026 การตรวจทานฉบับภาษาไทยนี้เมื่อ 30 กันยายน 2026 เป็นการตรวจสอบคำแปล ไม่ใช่การทดสอบใหม่ด้วยบัญชี ก่อนเปิดใช้การอัปเดตในระบบที่ใช้งานจริง ให้ทดสอบฟิลด์ปัจจุบัน การยืนยันตัวตน เนื้อหาคำขอ การตอบกลับ และการส่งคำขอซ้ำของแอ็กชันที่เลือกด้วยบัญชีของคุณเอง
แหล่งที่มาและเอกสาร
ฉบับภาษาไทยตรวจทานล่าสุดเมื่อ ข้อมูลของแต่ละแพลตฟอร์มอ้างอิงเอกสารสาธารณะที่ตรวจสอบเมื่อ 26 กันยายน 2026 การตรวจทานนี้ไม่ใช่การทดสอบใหม่ด้วยบัญชีที่เชื่อมต่อไว้ ตรวจสอบวิธีตั้งค่าและความพร้อมใช้งานปัจจุบันได้ในเอกสารอย่างเป็นทางการของแต่ละแพลตฟอร์ม