เลือกวิธีเชื่อมต่อ Zapier ที่ตรงกับข้อกำหนดของ API
การตั้งค่า HTTP ในคู่มือนี้เรียก GenderAPI.io V2 ที่ https://api.genderapi.io/api/v2/gender ส่ง type และ value ในเนื้อหา JSON ผลการคาดการณ์อยู่ใน data ส่วนข้อมูลคำขอและการหักเครดิตอยู่ใน meta ตัวเชื่อมต่อในตัวมีข้อกำหนดของตัวเองตามที่อธิบายไว้ด้านล่าง
Zapier มีแอ็กชัน GenderAPI.io สำหรับค้นหาเพศจากชื่อหรือที่อยู่อีเมล หน้ารายการสาธารณะเพียงอย่างเดียวไม่ได้ยืนยันเวอร์ชันของ endpoint หรือข้อกำหนดการตอบกลับของ V2 ก่อนเปลี่ยนการแมปฟิลด์ในขั้นตอนถัดไป ต้องตรวจสอบผลลัพธ์ของแอ็กชันในตัวที่มีอยู่
การตั้งค่า V2 ด้านล่างใช้ Webhooks by Zapier กับเพย์โหลด POST แบบมีโครงสร้าง การใช้ Webhooks ต้องมีแพ็กเกจ Zapier แบบชำระเงิน ยอดคงเหลือในบัญชี GenderAPI แยกจากการใช้งานงาน (task) ของ Zapier เอง
เตรียมบัญชีและเรคคอร์ดต้นทาง
ตัวอย่างนี้เพิ่มข้อมูลให้เรคคอร์ดใน Mailchimp จากที่อยู่อีเมล คุณต้องมีสิทธิ์เข้าถึงแอปต้นทางและแอปปลายทาง คีย์ API ของบัญชี GenderAPI.io และฟีเจอร์ของแพลตฟอร์มที่ใช้สร้างแอ็กชัน HTTP ได้ คู่มือนี้ไม่มีข้อมูลเข้าสู่ระบบที่ใช้งานได้จริงหรือบัญชีที่เชื่อมต่อไว้
V1 และ V2 ใช้คีย์ API ของบัญชีและยอดคงเหลือเดียวกัน ก่อนตั้งค่าคำขอที่มีการหักเครดิต ให้ตรวจสอบคีย์ด้วย GET /api/v2/usage และตรวจสอบว่าค่า meta.access.mode ในการตอบกลับของ endpoint นี้เป็น api_key หากไม่มีคีย์หรือระบบไม่รู้จักคีย์ อาจใช้การทดลองใช้ตาม IP ที่ใช้ร่วมกันแทน ระบบอัตโนมัติที่ใช้งานจริงไม่ควรพึ่งพาการทดลองใช้ตาม IP โดยไม่รู้ตัว
ปิดเวิร์กโฟลว์ไว้ระหว่างการตั้งค่า คำขอการคาดการณ์เพื่อทดสอบก็ถูกหักเครดิตตามปกติ คู่มือนี้ตรวจทานโดยอ้างอิงเอกสารสาธารณะและข้อกำหนดของ V2 การเผยแพร่ครั้งนี้ไม่ได้รันเวิร์กโฟลว์ที่ยืนยันตัวตนแล้วตั้งแต่ต้นจนจบบนแพลตฟอร์มใด
ตั้งค่าคำขอ GenderAPI.io V2 ใน Zapier
- เริ่มจากทริกเกอร์ Mailchimp ที่ให้เรคคอร์ดผู้ติดตามที่ต้องการ เก็บ ID ของกลุ่มเป้าหมาย (Audience) และผู้ติดต่อไว้ และเพิ่มตัวกรองที่ข้ามที่อยู่อีเมลว่างก่อนแอ็กชัน HTTP
- เลือก Webhooks by Zapier และแอ็กชัน POST ระบุ URL ด้านล่างและ Payload Type: JSON เพิ่มฟิลด์ข้อมูล type = email, value = ที่อยู่อีเมลของผู้ติดตามที่แมปไว้ และ options__ai_mode = off
- รูปแบบขีดล่างคู่ของ Zapier จะซ้อน options__ai_mode เป็น options.ai_mode ในเนื้อหาคำขอ JSON โค้ดบล็อกด้านล่างแสดงเนื้อหาที่ API ได้รับ ไม่ใช่ฟิลด์ที่สี่ที่ต้องวางลงในแอ็กชัน
- เพิ่ม Authorization ที่มีค่า Bearer YOUR_API_KEY ใน Headers และใช้ application/json เป็น Content-Type อย่าให้คีย์ปรากฏในฟิลด์ของทริกเกอร์ สตริงคิวรี หรือข้อมูลตัวอย่างการตอบกลับ
| การตั้งค่า 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": "email",
"value": "alex@example.com",
"options": {
"ai_mode": "off"
}
}ตรวจสอบขั้นตอน HTTP ก่อนเปิดการอัปเดต
ส่วนหัวของ Webhooks ไม่ใช่ฟิลด์การเชื่อมต่อสำหรับข้อมูลลับโดยเฉพาะ ทุกคนที่แก้ไข Zap ได้จะเห็นส่วนหัว จำกัดสิทธิ์การเข้าถึง และอย่าแชร์ Zap ภาพหน้าจอ หรือไฟล์ส่งออกที่มีข้อมูลรับรอง Zapier มี API by Zapier ที่ใช้ข้อมูลรับรองที่จัดเก็บไว้ด้วย แต่วิธีตั้งค่าเนื้อหาคำขอต่างจากการตั้งค่า POST แบบมีโครงสร้างนี้
อย่าห่อเนื้อหาคำขอ ให้ส่งออบเจ็กต์เดียว ไม่ใช่รายการหรืออาร์เรย์ สำหรับข้อมูลลูกค้าที่แมปไว้ ให้เลือกแอ็กชัน JSON แบบมีโครงสร้าง Custom Request ส่งข้อความดิบและไม่ escape ค่าที่แทรกไว้โดยอัตโนมัติ
แยกจัดการผลลัพธ์ 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 หรือไม่มีการตอบกลับที่สมบูรณ์ | หยุดการอัปเดตไว้ก่อน และตรวจสอบข้อผิดพลาดและสถานะการหักเครดิต การหมดเวลาไม่ได้หมายความว่าเซิร์ฟเวอร์ไม่ได้ทำงานใดเลย |
อัปเดตเฉพาะเรคคอร์ดที่ตรงกันใน Mailchimp
ตรวจสอบการตอบกลับที่แยกวิเคราะห์แล้วของแอ็กชันทดสอบ และเลือกฟิลด์ที่ตรงกับ data.gender, data.result_status และเส้นทาง V2 อื่นด้านล่าง ตัวเลือกฟิลด์ของ Zapier อาจทำให้ป้ายกำกับของฟิลด์ที่ซ้อนกันแบนราบ อย่าสันนิษฐานว่าฟิลด์ probability แบบเดิมของตัวเชื่อมต่อในตัวใช้ได้เหมือนเดิม ให้ยึดค่าที่ตรวจสอบจริงและเส้นทางระดับบน
ทดสอบผลลัพธ์ identified ผลลัพธ์ที่ไม่ทราบ และเส้นทางข้อผิดพลาดแยกกันก่อนเปิดการอัปเดต การใช้การตอบกลับตัวอย่างที่สร้างขึ้นช่วยให้ตรวจสอบเงื่อนไขของแต่ละเส้นทางได้โดยไม่ต้องส่งคำขอการคาดการณ์ใหม่ การอัปเดตในแอปปลายทางต้องเป็นไปตามผลการตรวจสอบด้านบน และต้องไม่เขียนทับฟิลด์หรือแท็กที่ไม่เกี่ยวข้อง
ควบคุมการส่งคำขอซ้ำและการหักเครดิตซ้ำ
ก่อนเปิด Zap ให้ตรวจทานการตั้งค่า Autoreplay และการรันซ้ำด้วยตนเอง (Replay) ของ Zapier การรันแอ็กชัน webhook ที่ล้มเหลวซ้ำจะส่งคำขอใหม่ ไม่ควรรันคำขอที่สำเร็จซ้ำเพียงเพื่อกู้คืนขั้นตอน Mailchimp ที่ตามมา จัดเก็บ ID เดิมของผู้ติดตามไว้คู่กับผลลัพธ์ของคำขอ
คำขอใหม่แต่ละครั้งที่ส่งไปยัง 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 อาจมีรายการที่ล้มเหลวอยู่ด้วย ต้องตรวจสอบแยกต่างหากว่าตัวเชื่อมต่อในตัวรองรับคำขอแบบกลุ่มหรือไม่
คำถามที่พบบ่อย
ทำไมการตั้งค่า Zapier จึงใช้ options__ai_mode?
แอ็กชัน POST แบบมีโครงสร้างของ Webhooks ใช้ขีดล่างคู่เพื่อสร้าง JSON แบบซ้อน API ได้รับ options: {ai_mode: off} โดย off เป็นสตริง API ไม่ได้รับฟิลด์ options__ai_mode ระดับบนสุดตามตัวอักษร
ตัวอย่างที่เรียก 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 การตรวจทานนี้ไม่ใช่การทดสอบใหม่ด้วยบัญชีที่เชื่อมต่อไว้ ตรวจสอบวิธีตั้งค่าและความพร้อมใช้งานปัจจุบันได้ในเอกสารอย่างเป็นทางการของแต่ละแพลตฟอร์ม