เชื่อมต่อ Pipedream กับ GenderAPI.io V2

เลือกวิธีเชื่อมต่อ Pipedream ที่ตรงกับข้อกำหนดของ API

การตั้งค่า HTTP ในคู่มือนี้เรียก GenderAPI.io V2 ที่ https://api.genderapi.io/api/v2/gender ส่ง type และ value ในเนื้อหา JSON ผลการคาดการณ์อยู่ใน data ส่วนข้อมูลคำขอและการหักเครดิตอยู่ใน meta ตัวเชื่อมต่อในตัวมีข้อกำหนดของตัวเองตามที่อธิบายไว้ด้านล่าง

คอมโพเนนต์ GenderAPI.io สาธารณะของ Pipedream ที่ตรวจทานเมื่อ 26 กันยายน 2026 ใช้ URL ฐานแบบเดิม https://api.genderapi.io/api และส่ง name หรือ email, country ที่ไม่บังคับ และคีย์ API เป็นพารามิเตอร์ในสตริงคิวรี การใช้งานที่เผยแพร่นี้เป็นตัวเชื่อมต่อ V1 ไม่ใช่ endpoint ของ V2 ที่ใช้ JSON

คุณคงแอ็กชันในตัวที่มีอยู่ไว้ตามข้อกำหนดของแอ็กชันนั้น หรือเพิ่มขั้นตอน HTTP ทั่วไปสำหรับ V2 ก็ได้ อย่าสันนิษฐานว่าการยืนยันตัวตนอัตโนมัติของบัญชีที่เชื่อมต่อในตัวจะใช้ได้กับคำขอ V2 ที่แยกต่างหากนี้ การตั้งค่านี้ใช้ส่วนหัว Bearer อย่างชัดเจน

เตรียมบัญชีและเรคคอร์ดต้นทาง

ตัวอย่างนี้เพิ่มข้อมูลให้เรคคอร์ดใน Twilio SendGrid จากที่อยู่อีเมล คุณต้องมีสิทธิ์เข้าถึงแอปต้นทางและแอปปลายทาง คีย์ API ของบัญชี GenderAPI.io และฟีเจอร์ของแพลตฟอร์มที่ใช้สร้างแอ็กชัน HTTP ได้ คู่มือนี้ไม่มีข้อมูลเข้าสู่ระบบที่ใช้งานได้จริงหรือบัญชีที่เชื่อมต่อไว้

V1 และ V2 ใช้คีย์ API ของบัญชีและยอดคงเหลือเดียวกัน ก่อนตั้งค่าคำขอที่มีการหักเครดิต ให้ตรวจสอบคีย์ด้วย GET /api/v2/usage และตรวจสอบว่าค่า meta.access.mode ในการตอบกลับของ endpoint นี้เป็น api_key หากไม่มีคีย์หรือระบบไม่รู้จักคีย์ อาจใช้การทดลองใช้ตาม IP ที่ใช้ร่วมกันแทน ระบบอัตโนมัติที่ใช้งานจริงไม่ควรพึ่งพาการทดลองใช้ตาม IP โดยไม่รู้ตัว

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

การยืนยันตัวตนและการตรวจสอบการใช้งานที่ไม่หักเครดิต

ตั้งค่าคำขอ GenderAPI.io V2 ใน Pipedream

เลือกเหตุการณ์หรือกำหนดเวลาของ Twilio SendGrid ที่เหมาะกับบัญชีและเวิร์กโฟลว์ ตรวจสอบผู้ติดต่อทดสอบหนึ่งราย เก็บ ID ที่คงที่ไว้ และข้ามค่าอีเมลที่ว่างก่อนขั้นตอนเพิ่มข้อมูล ช่วงเวลาที่ทริกเกอร์ใช้ได้เป็นการตั้งค่าของแพลตฟอร์ม ไม่ใช่สิ่งที่ GenderAPI รับประกัน
เพิ่มแอ็กชัน Send any HTTP Request เลือก POST แล้วระบุ URL ด้านล่าง กำหนดเนื้อหาคำขอ JSON ด้วย type = email, value = อีเมลของผู้ติดต่อ และ options.ai_mode = off
จัดเก็บคีย์ด้วยฟีเจอร์ข้อมูลรับรองหรือตัวแปรสภาพแวดล้อมของ Pipedream ตั้ง Authorization เป็น Bearer ตามด้วยค่าลับนั้น และตั้ง Content-Type เป็น application/json อย่านำการยืนยันตัวตนในตัวที่ใส่คีย์ในสตริงคิวรีกลับมาใช้ และอย่าพิมพ์คีย์ออกมาในขั้นตอนใด
สร้างเนื้อหาคำขอเป็นออบเจ็กต์ JSON ด้วยฟีเจอร์การแมปที่แอ็กชันรองรับ อย่าสร้าง JSON ดิบโดยต่อค่าของผู้ติดต่อที่ยังไม่ได้ escape ตรวจสอบตัวอย่างคำขอก่อนตั้งใจรันการทดสอบหนึ่งครั้ง

การตั้งค่า 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 ก่อนเปิดการอัปเดต

ตรวจสอบการตอบกลับที่ขั้นตอน HTTP ส่งออก และหาเนื้อหาที่แยกวิเคราะห์แล้ว หากแอ็กชันที่เลือกส่งคืนเนื้อหาเป็นข้อความ ให้แยกวิเคราะห์หนึ่งครั้งก่อนอ่าน data และ meta ฟิลด์ data ของตัวห่อการส่งข้อมูลต่างจากฟิลด์ data ในเนื้อหาของ V2

หากต้องการเวิร์กโฟลว์แบบใช้โค้ดที่จัดการการหมดเวลา การเปลี่ยนเส้นทาง และการส่งคำขอซ้ำอย่างชัดเจน ให้ใช้คู่มือ Node.js ที่ผ่านการทดสอบซึ่งลิงก์ไว้ด้านล่าง แอ็กชันทั่วไปและแอปในตัวอาจมีค่าเริ่มต้นในการส่งข้อมูลต่างกัน

แยกจัดการผลลัพธ์ 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 หรือไม่มีการตอบกลับที่สมบูรณ์	หยุดการอัปเดตไว้ก่อน และตรวจสอบข้อผิดพลาดและสถานะการหักเครดิต การหมดเวลาไม่ได้หมายความว่าเซิร์ฟเวอร์ไม่ได้ทำงานใดเลย

อัปเดตเฉพาะเรคคอร์ดที่ตรงกันใน Twilio SendGrid

เก็บ ID ผู้ติดต่อที่ได้จากทริกเกอร์ไว้คู่กับเนื้อหา V2 ที่แยกวิเคราะห์แล้ว หลังตรวจสอบผลลัพธ์ตามรายการด้านล่างแล้ว ให้อัปเดตเฉพาะฟิลด์ที่กำหนดเองของ SendGrid ที่วางแผนไว้ คงชื่อที่ผู้ติดต่อให้ไว้ตามเดิม data.name ที่ได้จากที่อยู่อีเมลเป็นเพียงชื่อตัวเลือกที่ได้จากการคาดการณ์ ไม่ใช่ค่าทดแทนที่ยืนยันแล้ว

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

ควบคุมการส่งคำขอซ้ำและการหักเครดิตซ้ำ

Pipedream ระบุในเอกสารว่าจะส่งซ้ำอัตโนมัติจากขั้นตอนที่ล้มเหลวตามแพ็กเกจที่ใช้ ตรวจทานการตั้งค่านี้และการส่งคำขอซ้ำของแอ็กชัน HTTP ที่เลือก การส่งขั้นตอนเพิ่มข้อมูลที่ล้มเหลวซ้ำอาจถูกหักเครดิตอีกครั้ง ความล้มเหลวที่เกิดในระบบปลายทางภายหลังควรกู้คืนด้วยผลลัพธ์การเพิ่มข้อมูลที่บันทึกไว้

คำขอใหม่แต่ละครั้งที่ส่งไปยัง 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 อาจมีรายการที่ล้มเหลวอยู่ด้วย ต้องตรวจสอบแยกต่างหากว่าตัวเชื่อมต่อในตัวรองรับคำขอแบบกลุ่มหรือไม่

คำถามที่พบบ่อย

แอ็กชัน GenderAPI.io ในตัวของ Pipedream ใช้ V2 หรือไม่?

คอมโพเนนต์สาธารณะที่ตรวจทานเมื่อ 26 กันยายน 2026 ใช้ endpoint แบบ V1 เดิมและการยืนยันตัวตนด้วยคีย์ในสตริงคิวรี สำหรับคำขอ V2 ให้ใช้การตั้งค่า HTTP สำหรับ V2 ที่ชัดเจน และตรวจสอบอีกครั้งหากเวอร์ชันของคอมโพเนนต์ที่เผยแพร่เปลี่ยนไป

ตัวอย่างที่เรียก 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 เป็นการตรวจสอบคำแปล ไม่ใช่การทดสอบใหม่ด้วยบัญชี ก่อนเปิดใช้การอัปเดตในระบบที่ใช้งานจริง ให้ทดสอบฟิลด์ปัจจุบัน การยืนยันตัวตน เนื้อหาคำขอ การตอบกลับ และการส่งคำขอซ้ำของแอ็กชันที่เลือกด้วยบัญชีของคุณเอง

แหล่งที่มาและเอกสาร

ฉบับภาษาไทยตรวจทานล่าสุดเมื่อ 30 กันยายน 2026 ข้อมูลของแต่ละแพลตฟอร์มอ้างอิงเอกสารสาธารณะที่ตรวจสอบเมื่อ 26 กันยายน 2026 การตรวจทานนี้ไม่ใช่การทดสอบใหม่ด้วยบัญชีที่เชื่อมต่อไว้ ตรวจสอบวิธีตั้งค่าและความพร้อมใช้งานปัจจุบันได้ในเอกสารอย่างเป็นทางการของแต่ละแพลตฟอร์ม