เลือกวิธีเชื่อมต่อ Make ที่ตรงกับข้อกำหนดของ API
การตั้งค่า HTTP ในคู่มือนี้เรียก GenderAPI.io V2 ที่ https://api.genderapi.io/api/v2/gender ส่ง type และ value ในเนื้อหา JSON ผลการคาดการณ์อยู่ใน data ส่วนข้อมูลคำขอและการหักเครดิตอยู่ใน meta ตัวเชื่อมต่อในตัวมีข้อกำหนดของตัวเองตามที่อธิบายไว้ด้านล่าง
Make มีแอป GenderAPI.io ที่มีแอ็กชันสำหรับชื่อและอีเมล หน้ารายการสาธารณะลิงก์ไปยัง genderapi.io แต่ไม่ได้ระบุเวอร์ชันเต็มของ endpoint หรือสคีมาการตอบกลับ ก่อนแมปฟิลด์ใน scenario ที่มีอยู่ ให้ตรวจสอบผลลัพธ์จริงของโมดูลที่เลือก
หากต้องการใช้การทำงานของ V2 อย่างชัดเจน ให้ใช้แอป HTTP ของ Make กับคำขอด้านล่าง การตั้งค่า HTTP ไม่ได้อัปเกรดโมดูล GenderAPI ที่มีอยู่ แยก scenario ที่ทำงานได้ดีไว้ต่างหากจนกว่าจะตรวจสอบการตั้งค่าที่ใช้แทนแล้ว
เตรียมบัญชีและเรคคอร์ดต้นทาง
ตัวอย่างนี้เพิ่มข้อมูลให้เรคคอร์ดใน Shopify จากที่อยู่อีเมล คุณต้องมีสิทธิ์เข้าถึงแอปต้นทางและแอปปลายทาง คีย์ API ของบัญชี GenderAPI.io และฟีเจอร์ของแพลตฟอร์มที่ใช้สร้างแอ็กชัน HTTP ได้ คู่มือนี้ไม่มีข้อมูลเข้าสู่ระบบที่ใช้งานได้จริงหรือบัญชีที่เชื่อมต่อไว้
V1 และ V2 ใช้คีย์ API ของบัญชีและยอดคงเหลือเดียวกัน ก่อนตั้งค่าคำขอที่มีการหักเครดิต ให้ตรวจสอบคีย์ด้วย GET /api/v2/usage และตรวจสอบว่าค่า meta.access.mode ในการตอบกลับของ endpoint นี้เป็น api_key หากไม่มีคีย์หรือระบบไม่รู้จักคีย์ อาจใช้การทดลองใช้ตาม IP ที่ใช้ร่วมกันแทน ระบบอัตโนมัติที่ใช้งานจริงไม่ควรพึ่งพาการทดลองใช้ตาม IP โดยไม่รู้ตัว
ปิดเวิร์กโฟลว์ไว้ระหว่างการตั้งค่า คำขอการคาดการณ์เพื่อทดสอบก็ถูกหักเครดิตตามปกติ คู่มือนี้ตรวจทานโดยอ้างอิงเอกสารสาธารณะและข้อกำหนดของ V2 การเผยแพร่ครั้งนี้ไม่ได้รันเวิร์กโฟลว์ที่ยืนยันตัวตนแล้วตั้งแต่ต้นจนจบบนแพลตฟอร์มใด
ตั้งค่าคำขอ GenderAPI.io V2 ใน Make
- เลือกทริกเกอร์ลูกค้าของ Shopify ที่เหมาะกับ scenario และโหลดเรคคอร์ดทดสอบที่เป็นตัวแทนของข้อมูลจริง เก็บ ID ลูกค้าไว้จนถึงการอัปเดตขั้นสุดท้าย และข้ามเรคคอร์ดที่อีเมลว่าง
- เพิ่ม HTTP > Make a request ในแอป HTTP ปัจจุบัน ให้เลือกการยืนยันตัวตนแบบ API key และสร้างข้อมูลรับรองที่มีค่าคีย์ Bearer YOUR_API_KEY ตำแหน่ง Header และชื่อพารามิเตอร์ Authorization อย่าใส่คีย์ใน URL ให้ใช้ที่จัดเก็บข้อมูลรับรองแทน
- ตั้งเมธอดเป็น POST และ URL เป็นค่าที่แสดงด้านล่าง เลือก application/json สำหรับเนื้อหาคำขอ และเลือกโครงสร้างข้อมูลที่ประกอบด้วยฟิลด์สตริง type และ value พร้อมคอลเลกชัน options ที่มีฟิลด์สตริง ai_mode ตั้ง type เป็น email และ ai_mode เป็น off แล้วแมปอีเมลของลูกค้าไปที่ value
- เปิด Parse response เนื้อหาคำขอที่สร้างจากโครงสร้างข้อมูลของ Make จะแปลงค่าที่แมปไว้เป็น 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": "email",
"value": "alex@example.com",
"options": {
"ai_mode": "off"
}
}ตรวจสอบขั้นตอน HTTP ก่อนเปิดการอัปเดต
ปิดการเปลี่ยนเส้นทางไว้สำหรับปลายทาง HTTPS API ที่คงที่นี้ หากเปลี่ยนเวอร์ชันของแอป HTTP ของ Make ให้ตรวจทานการตั้งค่าการยืนยันตัวตนและเนื้อหาคำขออีกครั้ง เพราะรายการตั้งค่าอาจแตกต่างกัน
ตั้งใจรันการทดสอบหนึ่งครั้ง ตรวจสอบบันเดิล (bundle) การตอบกลับที่แยกวิเคราะห์แล้ว จากนั้นสร้างเส้นทาง (route) แยกกันสำหรับผลลัพธ์ identified ที่ยอมรับ ผลลัพธ์ที่ไม่ทราบ และความล้มเหลวในการทำงาน ก่อนเพิ่มการอัปเดตลูกค้า
แยกจัดการผลลัพธ์ 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
แมปเส้นทางเนื้อหาการตอบกลับของ V2 ด้านล่างจากการตอบกลับ HTTP ที่แยกวิเคราะห์แล้ว Make อาจวางเนื้อหาไว้ใต้ป้ายกำกับผลลัพธ์ของโมดูล จึงควรเลือกออบเจ็กต์ data และ meta ที่ซ้อนอยู่จากบันเดิลที่ตรวจสอบแล้ว อัปเดตเฉพาะลูกค้าที่ตรงกับ ID ลูกค้าที่ทริกเกอร์บันทึกไว้ และใช้ฟิลด์แยกสำหรับข้อมูลที่ได้จากการคาดการณ์หรือนโยบายแท็กที่กำหนดไว้
ทดสอบผลลัพธ์ identified ผลลัพธ์ที่ไม่ทราบ และเส้นทางข้อผิดพลาดแยกกันก่อนเปิดการอัปเดต การใช้การตอบกลับตัวอย่างที่สร้างขึ้นช่วยให้ตรวจสอบเงื่อนไขของแต่ละเส้นทางได้โดยไม่ต้องส่งคำขอการคาดการณ์ใหม่ การอัปเดตในแอปปลายทางต้องเป็นไปตามผลการตรวจสอบด้านบน และต้องไม่เขียนทับฟิลด์หรือแท็กที่ไม่เกี่ยวข้อง
ควบคุมการส่งคำขอซ้ำและการหักเครดิตซ้ำ
ตรวจทานการตั้งค่าตัวจัดการข้อผิดพลาด (error handler) และการรันที่ไม่สมบูรณ์ (incomplete execution) ของ Make ข้อผิดพลาดชั่วคราวบางอย่างอาจถูกส่งซ้ำได้แม้ไม่มีตัวจัดการ Retry ที่ระบุไว้ชัดเจน การส่งโมดูล HTTP ซ้ำอาจส่งคำขอที่มีการหักเครดิตใหม่ หากคำขอสำเร็จแต่การอัปเดต 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 อาจมีรายการที่ล้มเหลวอยู่ด้วย ต้องตรวจสอบแยกต่างหากว่าตัวเชื่อมต่อในตัวรองรับคำขอแบบกลุ่มหรือไม่
คำถามที่พบบ่อย
ควรวางคีย์ API ลงใน URL ของ Make หรือไม่?
ไม่ ในการตั้งค่า HTTP สำหรับ V2 ให้จัดเก็บ Bearer YOUR_API_KEY ในข้อมูลรับรองประเภท API key โดยกำหนดตำแหน่งเป็น Header และชื่อพารามิเตอร์เป็น Authorization ทั้งนี้ endpoint แบบ POST ไม่รับพารามิเตอร์ key ในสตริงคิวรี
ตัวอย่างที่เรียก 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 การตรวจทานนี้ไม่ใช่การทดสอบใหม่ด้วยบัญชีที่เชื่อมต่อไว้ ตรวจสอบวิธีตั้งค่าและความพร้อมใช้งานปัจจุบันได้ในเอกสารอย่างเป็นทางการของแต่ละแพลตฟอร์ม