สร้างการทดสอบยืนยัน +592 โดยใช้ webhook และ polling

ฉันจะออกแบบโฟลว์ API OTP ของกายอานาแบบ webhook-first ได้อย่างไร?

สำหรับงานที่เกินกว่าการตรวจสอบครั้งเดียว ให้แพลตฟอร์มส่งรหัสมาให้คุณ แทนการถามซ้ำแล้วซ้ำอีก ใน Developer console ให้เพิ่ม endpoint แบบ HTTPS (หนึ่งบัญชีมีได้ 5 รายการ) และสมัครรับ activation.sms_received พร้อมกับ activation.expired และ activation.cancelled เพื่อให้ตัวรันการทดสอบของคุณรู้เรื่องทางตันเร็วพอ ๆ กับที่รู้เรื่องความสำเร็จ

ถือว่าทุกคำขอที่เข้ามาเชื่อถือไม่ได้จนกว่าจะผ่านการตรวจสอบ

• อ่านเฮดเดอร์ X-OTPRoute-Signature ซึ่งอยู่ในรูปแบบ t=<unix>,v1=<hex>
• นำ timestamp, จุด และเนื้อหาคำขอที่ไม่ผ่านการแก้ไขมาต่อกัน แล้วคำนวณ HMAC-SHA256 ของสตริงนั้นด้วย secret ของ endpoint
• เปรียบเทียบ digest ของคุณกับ v1 ด้วยการเปรียบเทียบแบบ constant time และทิ้งคำขอหาก timestamp เก่าเกินไป
• หา activation id ในอีเวนต์ หากคุณประมวลผลไปแล้ว ให้ตอบสำเร็จและไม่ต้องทำอะไรเพิ่ม

กฎข้อสุดท้ายทำให้ตัวจัดการเป็น idempotent การส่งซ้ำหลังเครือข่ายสะดุดจึงไม่ทำให้การทดสอบสับสน อ่านเพิ่มเติมได้ที่การรับ OTP ด้วย webhook

คำสั่งซื้อ +592 ใช้ endpoint และ id อะไรบ้าง?

ยืนยันตัวตนด้วยคีย์ Bearer จาก Developer console คีย์ live ขึ้นต้นด้วย or_live_ และแต่ละบัญชีเก็บได้สูงสุด 10 คีย์ Base URL คือ https://otproute.com/api/v1 และ country id ของกายอานาคือ gy

การรันทั่วไปจะอ่าน GET /api/v1/prices?country=gy&service=<id> ก่อน เพราะราคาและความพร้อมใช้งานของเส้นทางนี้เป็นค่าสด ไม่ใช่ค่าคงที่ จากนั้นส่ง POST /api/v1/activations พร้อม {"service": "<id>", "country": "gy"} และรับเบอร์ +592 กับ activation id กลับมา หากไม่ใช้ webhook ตัวรันจะ poll GET /api/v1/activations/{id} ทุกไม่กี่วินาที ซึ่งต่ำกว่าเพดาน 300 คำขอต่อนาทีมาก ขั้นตอน teardown จะเรียก POST /api/v1/activations/{id}/cancel เมื่อการทดสอบยกเลิก และการเรียก GET /api/v1/balance ล่วงหน้าจะหยุดชุดทดสอบตั้งแต่ต้นหากยอดในกระเป๋าต่ำ service id มาจาก GET /api/v1/services และศูนย์นักพัฒนามีตัวอย่างไคลเอนต์สำหรับ SMS verification API นี้

เบอร์ +592 จัดรูปแบบสำหรับจัดเก็บอย่างไร?

กายอานาใช้รหัสประเทศ 592 และเบอร์ภายในประเทศ 7 หลักโดยไม่มี trunk prefix ให้ตัดออก ดังนั้นรูปแบบ E.164 คือ +592 ตามด้วยเลข 7 หลักนั้น ผู้คนมักเขียนตัวเลขเป็นกลุ่ม 3 หลักและกลุ่ม 4 หลัก

เมื่อไม่มีเลขศูนย์นำหน้าให้ลบ การปรับข้อมูลจึงเหลือแค่ลบช่องว่างและขีดกลาง และเติมรหัสประเทศเมื่อผู้ใช้พิมพ์เฉพาะเลขท้องถิ่น บั๊กที่พบบ่อยคือฟอร์มที่สมมติว่าเบอร์ทุกเบอร์ในอเมริกาใต้มีรหัสพื้นที่ หรือกำหนดความยาวขั้นต่ำเกิน 7 หลัก จึงปฏิเสธข้อมูลที่ถูกต้องของชาวกายอานา เบอร์ +592 สำหรับทดสอบเผยปัญหานี้ได้อย่างรวดเร็ว ให้บันทึกสตริง E.164 และใช้รูปแบบท้องถิ่นเฉพาะตอนแสดงผล

บริการใดรับรหัส SMS OTP ของกายอานาได้ และสั่งด้วยตนเองได้ไหม?

เส้นทางกายอานามีบริการมากกว่า 900 รายการ บริการที่มีการร้องขอบ่อย ได้แก่ WhatsApp, Facebook, Instagram, Google (Gmail & YouTube), TikTok, Telegram, imo, Viber, Snapchat, Amazon, Microsoft & Outlook, Discord, Netflix และ Claude รายการนี้เป็นภาพรวมของแคตตาล็อกสด ดังนั้นโปรดยืนยันผ่าน API หรือแดชบอร์ดก่อนวางแผนการทดสอบรอบผู้ส่งรายใดรายหนึ่ง

สำหรับเพื่อนร่วมงานที่ไม่เขียนโค้ด แดชบอร์ดทำงานเดียวกันได้ เข้าสู่ระบบ เปิด OTP Gateway เลือกกายอานาและบริการ ตรวจสอบราคา แล้วสั่งซื้อ เบอร์ยืนยันของกายอานาจะปรากฏพร้อมตัวนับถอยหลัง 20 นาที และรหัสจะแสดงข้าง ๆ เมื่อมาถึง

การทดสอบควรทำอย่างไรเมื่อรหัส +592 มาช้าหรือไม่มา?

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

วิธีจัดการที่เหมาะสมในการรันอัตโนมัติ

1. รอให้ครบช่วงเวลาก่อนประกาศว่าล้มเหลว เว้นแต่การทดสอบของคุณมีเวลาจำกัดตายตัว ในกรณีนั้นให้ยกเลิกอย่างชัดเจน
2. ลองใหม่ภายหลัง หรือเปลี่ยนไปเส้นทางบริการอื่นหาก API มีให้
3. ตรวจสอบว่าบริการเป้าหมายรับเบอร์เสมือนหรือไม่ บางบริการปฏิเสธ และการคืนเงินครอบคลุมกรณีนี้พอดี
4. เว้นระยะการลองใหม่ด้วย backoff แทนการสั่งซื้อซ้ำในลูปที่ถี่

คู่มือการกำหนดเส้นทาง OTP ตามประเทศอธิบายวิธีเลือกเส้นทางสำรอง

ทำไมทีมจึงทดสอบโฟลว์สมัครใช้งานของกายอานา?

กายอานาเป็นประเทศเดียวในอเมริกาใต้ที่ใช้ภาษาอังกฤษเป็นภาษาราชการ และจอร์จทาวน์เป็นที่ตั้งสำนักเลขาธิการ CARICOM จึงมักปรากฏในการเปิดตัวที่มองประชาคมแคริบเบียนเป็นตลาดเดียว ภาคพลังงานนอกชายฝั่งที่เติบโตเร็วดึงดูดผู้รับเหมาและซัพพลายเออร์ระดับสากล ขณะที่ชาวกายอานาจำนวนมากในสหรัฐฯ แคนาดา และสหราชอาณาจักรทำให้แอปโอนเงิน แอปส่งข้อความ และแอปท่องเที่ยวใช้งานบนเบอร์ +592 อย่างคึกคัก ภาษากรีโอลกายอานาใช้พูดกันอย่างแพร่หลายในชีวิตประจำวัน แต่ข้อความยืนยันโดยทั่วไปมาเป็นภาษาอังกฤษ สำหรับ QA นั่นหมายความว่าควรเน้นที่การกรอกเบอร์ ตัวเลือกประเทศ และถ้อยคำการยินยอมรับ SMS มากกว่าข้อความที่แปลแล้ว ให้ทุกการตรวจสอบอยู่บนบัญชีที่องค์กรของคุณเป็นเจ้าของ ปฏิบัติตามข้อกำหนดของแต่ละบริการ และจำไว้ว่านโยบายการใช้งานที่ยอมรับได้ของ OTP Route ครอบคลุมทุกคำสั่งซื้อ

ฉันเก็บเบอร์กายอานาไว้ระยะยาวได้ไหม และคิดค่าใช้งานอย่างไร?

เบอร์ระยะยาวแบบสั่งซื้อเองไม่มีให้บริการสำหรับกายอานา Dedicated Numbers ของ OTP Route ครอบคลุมเฉพาะสหรัฐอเมริกาและแคนาดา เริ่มต้น $1.95/เดือน สำหรับเบอร์ +592 ให้ส่งอีเมลถึง [email protected] แล้วทีมงานจะตรวจสอบว่ากฎระเบียบในท้องถิ่นอนุญาตอะไรได้บ้าง โดยไม่มีคำมั่นสัญญา

การชำระเงินทำผ่านกระเป๋าเงิน USD แบบเติมก่อนใช้ ไม่มีค่าธรรมเนียมรายเดือน ไม่มีแผน เติมเงินด้วยบัตรหรือ USDT/USDC และรับใบแจ้งหนี้ PDF ทางอีเมลทุกครั้ง บัญชีพัฒนาย้ายไปใช้ sandbox ได้เมื่อร้องขอ การทดสอบการเชื่อมต่อจึงรันกับเบอร์และรหัสจำลองโดยไม่แตะยอดคงเหลือ อัตราต่อบริการแสดงอยู่ในหน้าราคา

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

ฉันตรวจสอบการสมัครใช้งานแอปสำหรับกายอานาโดยไม่มีซิมจากผู้ให้บริการในกายอานาได้ไหม?

ได้ สั่งเบอร์ +592 จาก OTP Gateway สำหรับบริการของคุณ กรอกในโฟลว์ของคุณ แล้วรหัสจะแสดงในแดชบอร์ดหรือส่งถึง webhook ของคุณ ราคาเริ่มต้นที่ $0.20 ต่อรหัส

API ใช้ country id อะไรสำหรับกายอานา?

คือ gy ใช้ทั้งใน query ราคาและในเนื้อหาคำขอ activation

ฉันต้องตัดเลขศูนย์นำหน้าของเบอร์กายอานาออกไหม?

ไม่ต้อง กายอานาไม่มี trunk prefix ดังนั้นรูปแบบ E.164 คือ +592 ตามด้วยเบอร์ 7 หลัก

ข้อความยืนยัน +592 มาเป็นภาษาอะไร?

โดยปกติเป็นภาษาอังกฤษซึ่งเป็นภาษาราชการ อย่างไรก็ตามผู้ส่งเป็นผู้กำหนดถ้อยคำ และอาจเป็นไปตามการตั้งค่าภาษาของแอป

มีการคืนเงินหากบริการไม่เคยส่ง SMS ไหม?

มี และเป็นแบบอัตโนมัติ หากผ่านไป 20 นาทีโดยไม่มีรหัส หรือคุณยกเลิก เงินทั้งหมดจะกลับเข้ากระเป๋าเงินของคุณ

ฉันทดสอบการเชื่อมต่อทั้งหมดโดยไม่เสียเงินได้ไหม?

ขอให้ซัพพอร์ตเปลี่ยนบัญชีพัฒนาของคุณเป็น sandbox ซึ่งคืนเบอร์และรหัสจำลอง คุณจึงทดสอบการเรียก API และ webhook ได้ตั้งแต่ต้นจนจบ

มีเบอร์ +592 ระยะยาวไหม?

ไม่มีในรูปแบบสั่งซื้อเอง Dedicated Numbers จำหน่ายเฉพาะสหรัฐอเมริกาและแคนาดา ส่งอีเมลถึง [email protected] เพื่อสอบถามเรื่องกายอานา

ชื่อบริการเป็นเครื่องหมายการค้าของเจ้าของนั้น ๆ OTP Route ไม่มีความเกี่ยวข้องกับบริการเหล่านั้น โปรดใช้หมายเลขอย่างถูกกฎหมาย และปฏิบัติตามข้อกำหนดของแต่ละบริการและนโยบายการใช้งานที่ยอมรับได้ของเรา