เลือกวิธีเชื่อมต่อ Integrately ที่ตรงกับข้อกำหนดของ API
การตั้งค่า HTTP ในคู่มือนี้เรียก GenderAPI.io V2 ที่ https://api.genderapi.io/api/v2/gender ส่ง type และ value ในเนื้อหา JSON ผลการคาดการณ์อยู่ใน data ส่วนข้อมูลคำขอและการหักเครดิตอยู่ใน meta ตัวเชื่อมต่อในตัวมีข้อกำหนดของตัวเองตามที่อธิบายไว้ด้านล่าง
หน้ารายการ GenderAPI.io ของ Integrately ลิงก์ไปยัง genderapi.io และมีแอ็กชันสำหรับชื่อ ที่อยู่อีเมล และการดึงชื่อต้นจากที่อยู่อีเมล หน้ารายการไม่ได้ระบุเวอร์ชันของ API ที่อยู่เบื้องหลังหรือสคีมาผลลัพธ์ฉบับเต็ม ชื่อแอ็กชันเพียงอย่างเดียวยืนยันความเข้ากันได้กับ V2 ไม่ได้
Integrately ระบุในเอกสารว่า Webhook/API เป็นแอ็กชัน POST ที่ส่งออกไปภายนอก คู่มือนี้ไม่ได้ตรวจสอบการตั้งค่าส่วนหัวและฟีเจอร์ตัวแก้ไข JSON ในปัจจุบันด้วยตนเอง ใช้ข้อกำหนด HTTP ของ V2 ด้านล่างหลังจากยืนยันแล้วว่าแอ็กชันของคุณส่งส่วนหัว Authorization และเนื้อหาคำขอ JSON แบบซ้อนได้เท่านั้น แอ็กชันในตัวที่มีอยู่ยังคงใช้ข้อกำหนดฟิลด์ของตนเอง
เตรียมบัญชีและเรคคอร์ดต้นทาง
ตัวอย่างนี้เพิ่มข้อมูลให้เรคคอร์ดใน Mailchimp จากชื่อ คุณต้องมีสิทธิ์เข้าถึงแอปต้นทางและแอปปลายทาง คีย์ API ของบัญชี GenderAPI.io และฟีเจอร์ของแพลตฟอร์มที่ใช้สร้างแอ็กชัน HTTP ได้ คู่มือนี้ไม่มีข้อมูลเข้าสู่ระบบที่ใช้งานได้จริงหรือบัญชีที่เชื่อมต่อไว้
V1 และ V2 ใช้คีย์ API ของบัญชีและยอดคงเหลือเดียวกัน ก่อนตั้งค่าคำขอที่มีการหักเครดิต ให้ตรวจสอบคีย์ด้วย GET /api/v2/usage และตรวจสอบว่าค่า meta.access.mode ในการตอบกลับของ endpoint นี้เป็น api_key หากไม่มีคีย์หรือระบบไม่รู้จักคีย์ อาจใช้การทดลองใช้ตาม IP ที่ใช้ร่วมกันแทน ระบบอัตโนมัติที่ใช้งานจริงไม่ควรพึ่งพาการทดลองใช้ตาม IP โดยไม่รู้ตัว
ปิดเวิร์กโฟลว์ไว้ระหว่างการตั้งค่า คำขอการคาดการณ์เพื่อทดสอบก็ถูกหักเครดิตตามปกติ คู่มือนี้ตรวจทานโดยอ้างอิงเอกสารสาธารณะและข้อกำหนดของ V2 การเผยแพร่ครั้งนี้ไม่ได้รันเวิร์กโฟลว์ที่ยืนยันตัวตนแล้วตั้งแต่ต้นจนจบบนแพลตฟอร์มใด
ตั้งค่าคำขอ GenderAPI.io V2 ใน Integrately
- เลือกทริกเกอร์ผู้ติดตามของ Mailchimp และตรวจสอบเรคคอร์ดทดสอบหนึ่งรายการ เก็บ ID ของกลุ่มเป้าหมาย (Audience) และผู้ติดตามไว้สำหรับการอัปเดต เลือกฟิลด์ชื่อต้นจริง และข้ามเรคคอร์ดที่ไม่มีชื่อ
- หา Webhook/API และแอ็กชันที่ส่งข้อมูลไปยัง URL ตรวจสอบการตั้งค่าที่มีให้ก่อนดำเนินการต่อ ข้อกำหนดด้านล่างต้องใช้ส่วนหัวการยืนยันตัวตนและเนื้อหาคำขอ JSON แบบซ้อน และคู่มือนี้ไม่ได้ตรวจสอบฟีเจอร์ตัวแก้ไขในปัจจุบันด้วยตนเอง
- หากแอ็กชันรองรับข้อกำหนดเหล่านี้ ให้เลือก POST และ endpoint ของ V2 ด้านล่าง ใช้การตั้งค่าที่มีในบัญชีของคุณเพื่อให้คำขอที่ส่งออกมี Authorization: Bearer YOUR_API_KEY และ Content-Type: application/json
- สร้างเนื้อหาคำขอ JSON ด้วย type = name, value = ชื่อต้นที่แมปไว้ และ options ที่มี ai_mode = off ตรวจสอบตัวอย่างคำขอของแอ็กชันที่เลือก เพย์โหลดแบบฟอร์มแบบแบนราบไม่ใช่เนื้อหาคำขอ JSON ของ V2
- สำหรับชื่อที่เปลี่ยนแปลงได้ ให้ใช้ฟีเจอร์การแมปหรือการแปลงเป็น JSON ของแพลตฟอร์ม หากแอ็กชันที่เลือกคง JSON แบบซ้อนหรือส่วนหัวการยืนยันตัวตนไว้ไม่ได้ ให้ใช้ขั้นตอนที่รองรับ HTTP อย่าใส่คีย์หรือ 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 ก่อนเปิดการอัปเดต
ตั้งใจทดสอบแอ็กชันหนึ่งรายการ และตรวจสอบเนื้อหาที่ส่งคืนก่อนเลือกฟิลด์สำหรับขั้นตอนถัดไป แม้ลูกค้าต้นทางจะเป็นรายเดียวกัน ขั้นตอน GenderAPI.io ในตัวกับขั้นตอน Webhook/API อาจแสดงป้ายกำกับฟิลด์ต่างกัน
เก็บคีย์ไว้ในการตั้งค่าการเชื่อมต่อหรือการยืนยันตัวตนของคำขอ และจำกัดผู้ที่ดูหรือแชร์ระบบอัตโนมัติได้ คู่มือสาธารณะนี้ไม่มีคีย์ที่ใช้งานได้ การเชื่อมต่อที่ส่งออก หรือการอัปเดตลูกค้าที่ตั้งค่าไว้ล่วงหน้า
แยกจัดการผลลัพธ์ 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
เลือกเรคคอร์ดปลายทางด้วย ID ของกลุ่มเป้าหมาย (Audience) และผู้ติดตามของ Mailchimp ที่บันทึกไว้ ก่อนเขียนลงฟิลด์แยกสำหรับข้อมูลที่ได้จากการคาดการณ์หรือแท็กที่อนุมัติแล้ว ให้เพิ่มเงื่อนไขสำหรับสถานะผลลัพธ์และการตรวจสอบการเข้าถึงและการหักเครดิตด้านล่าง อย่าเปลี่ยนค่าเพศที่ไม่มีหรือเป็น null ให้เป็นหมวดหมู่เริ่มต้นของผู้ติดต่อ
ทดสอบผลลัพธ์ identified ผลลัพธ์ที่ไม่ทราบ และเส้นทางข้อผิดพลาดแยกกันก่อนเปิดการอัปเดต การใช้การตอบกลับตัวอย่างที่สร้างขึ้นช่วยให้ตรวจสอบเงื่อนไขของแต่ละเส้นทางได้โดยไม่ต้องส่งคำขอการคาดการณ์ใหม่ การอัปเดตในแอปปลายทางต้องเป็นไปตามผลการตรวจสอบด้านบน และต้องไม่เขียนทับฟิลด์หรือแท็กที่ไม่เกี่ยวข้อง
ควบคุมการส่งคำขอซ้ำและการหักเครดิตซ้ำ
Integrately ระบุในเอกสารถึงการส่งซ้ำอัตโนมัติ รวมถึงการตั้งค่าที่มีผลทั้งบริษัท ก่อนเปิดระบบอัตโนมัตินี้ ให้ตรวจสอบนโยบายและประวัติงาน และประเมินผลกระทบต่อเวิร์กโฟลว์อื่นก่อนเปลี่ยนการตั้งค่าที่ใช้ร่วมกัน คำขอ HTTP ที่ส่งซ้ำแต่ละครั้งเป็นคำขอที่หักเครดิตแยกกัน เก็บผลลัพธ์ที่สำเร็จไว้ เพื่อให้กู้คืนความล้มเหลวของ Mailchimp ที่เกิดภายหลังได้โดยไม่ต้องส่งคำขอใหม่
คำขอใหม่แต่ละครั้งที่ส่งไปยัง 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 อาจมีรายการที่ล้มเหลวอยู่ด้วย ต้องตรวจสอบแยกต่างหากว่าตัวเชื่อมต่อในตัวรองรับคำขอแบบกลุ่มหรือไม่
คำถามที่พบบ่อย
แมปฟิลด์ probability ของแอ็กชันในตัวแบบเดิมไปยัง confidence ของ V2 ได้หรือไม่?
ตรวจทานข้อกำหนดการตอบกลับก่อน คำขอ V2 โดยตรงส่งคืน data.confidence พร้อม data.confidence_kind บนช่วง 0 ถึง 1 หรือเป็น null อย่าสันนิษฐานว่าป้ายกำกับฟิลด์และช่วงค่าของตัวเชื่อมต่อในตัวตรงกับเส้นทางเหล่านี้
ตัวอย่างที่เรียก 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 การตรวจทานนี้ไม่ใช่การทดสอบใหม่ด้วยบัญชีที่เชื่อมต่อไว้ ตรวจสอบวิธีตั้งค่าและความพร้อมใช้งานปัจจุบันได้ในเอกสารอย่างเป็นทางการของแต่ละแพลตฟอร์ม