รหัสยืนยันของแองกวิลลา (+1 264) เช็กลิสต์ ขั้นตอน API และวิธีแก้ปัญหา

เช็กลิสต์ก่อนเริ่ม: ควรเตรียมอะไรให้พร้อมก่อนสั่งเบอร์แองกวิลลาครั้งแรก?

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

• API key สร้างใน Developer console คีย์ขึ้นต้นด้วย or_live_ และหนึ่งบัญชีมีได้สูงสุด 10 คีย์ ดังนั้นควรแยกคีย์ให้ staging และ CI
• เงินในกระเป๋าเงิน เรียก GET /api/v1/balance ตอนต้นของชุดทดสอบ จะทำให้การรันล้มเหลวตั้งแต่ต้น แทนที่จะล้มกลางทาง
• country id ที่ถูกต้อง แองกวิลลาคือ ai ใน API รหัสสองตัวอักษรนี้สับสนกับป้าย "AI" ในไฟล์ config อื่นได้ง่าย จึงควรเก็บไว้ในค่าคงที่ที่ตั้งชื่อชัดเจน
• service id ดึงจาก GET /api/v1/services แทนการเดา slug
• endpoint เว็บฮุก (ไม่บังคับ) ลงทะเบียนในคอนโซล เก็บ secret ไว้ และกำหนดว่า handler จะหาการทดสอบที่กำลังรออยู่ได้อย่างไร
• ช่องกรอกเบอร์โทรที่รับ +1 นอกสหรัฐฯ ข้อนี้เป็นสิ่งที่ทีมมักพบช้าเกินไป ส่วนถัดไปอธิบายเหตุผล

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

ทำไมเบอร์ +1 264 จึงทำให้การตรวจสอบเบอร์โทรสะดุด?

แองกวิลลาอยู่ในแผนหมายเลขอเมริกาเหนือ (NANP) จึงใช้รหัสประเทศ +1 ร่วมกับสหรัฐอเมริกา แคนาดา และดินแดนในแคริบเบียนอีกมากมาย สิ่งที่ระบุเกาะนี้คือรหัสพื้นที่ 264 เบอร์แองกวิลลาคือ +1 ตามด้วย 264 แล้วตามด้วยเลขเจ็ดหลัก รวมสิบหลักหลัง +1 ภายใน NANP trunk prefix ภายในประเทศคือ 1 ซึ่งเป็นเหตุผลที่เอกสารท้องถิ่นอาจเขียนเบอร์เดียวกันเป็น 1-264-xxx-xxxx

รหัสประเทศที่ใช้ร่วมกันนี้ก่อให้เกิดบั๊กที่พบบ่อยหลายอย่าง

• ฟอร์มที่ถือว่าทุกเบอร์ +1 เป็นเบอร์อเมริกัน แล้วพยายามแมปเป็นรัฐของสหรัฐฯ
• ตัวเลือกประเทศที่บันทึกเป็น "US" สำหรับทุกเบอร์ที่ขึ้นต้นด้วย +1 ซึ่งทำให้การวิเคราะห์และการค้นหานโยบาย SMS คลาดเคลื่อน
• validator ที่ปฏิเสธรหัสพื้นที่ที่ไม่รู้จัก

เก็บเบอร์ในรูปแบบ E.164 เป็น +1264 ตามด้วยเลขสมาชิกเจ็ดหลัก และหาภูมิภาคจากคำนำหน้าทั้งหมดด้วยไลบรารีหมายเลขที่ดูแลอยู่เสมอ แทนที่จะดูจากรหัสประเทศเพียงอย่างเดียว ภาษาอังกฤษเป็นภาษาราชการ ข้อความยืนยันบนเส้นทางนี้จึงมักมาเป็นเทมเพลตภาษาอังกฤษของบริการ ทำให้ดึงรหัสออกมาได้ง่าย ทีมมักทดสอบที่นี่เมื่อเปิดตัวในแคริบเบียนตะวันออก ให้บริการลูกค้าด้านท่องเที่ยวและโรงแรม หรือเพียงต้องการพิสูจน์ว่าการจัดการ NANP ของตนใช้ได้นอกเหนือจาก 50 รัฐ

ทีละขั้น: สั่งเบอร์แองกวิลลาผ่าน API

ทุกการเรียกไปที่ https://otproute.com/api/v1 โดยใส่คีย์ในเฮดเดอร์ Bearer

1. ยืนยันเส้นทางด้วย GET /api/v1/countries และแคชผลลัพธ์ไว้ทั้งวัน
2. ขอราคาสด: GET /api/v1/prices?country=ai&service=<id> ราคาและความพร้อมใช้งานเปลี่ยนแปลงระหว่างวัน จึงควรสอบถามทุกครั้งที่รัน แทนการฮาร์ดโค้ด
3. สร้าง activation ด้วย POST /api/v1/activations พร้อมข้อมูล {"service": "<id>", "country": "ai"} ผลตอบกลับมี activation id และเบอร์ +1 264
4. พิมพ์เบอร์ลงในหน้าสมัครสมาชิกหรือล็อกอินของผลิตภัณฑ์ที่คุณกำลังทดสอบ
5. รอเหตุการณ์ activation.sms_received ที่เว็บฮุกของคุณ หรือโพล GET /api/v1/activations/{id} ทุกไม่กี่วินาที ขีดจำกัด 300 คำขอต่อนาทีเหลือที่ว่างเพียงพอ
6. หากการทดสอบถูกยกเลิกกลางคัน ให้ปล่อยคำสั่งซื้อด้วย POST /api/v1/activations/{id}/cancel เพื่อให้เงินที่กันไว้คืนเข้ากระเป๋าเงิน

เอกสารอ้างอิงคำขอและการตอบกลับฉบับเต็มอยู่ในเอกสาร API

บริการใดบ้างที่รับรหัสบนเส้นทางแองกวิลลาได้?

เส้นทางแองกวิลลาในปัจจุบันมีบริการมากกว่า 600 รายการ ที่เป็นที่นิยมในสแนปช็อตวันนี้ ได้แก่ WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Amazon, Discord, LinkedIn, Uber และ Airbnb แอปท่องเที่ยวและเรียกรถมักสำคัญสำหรับทีมที่ทำงานกับผู้มาเยือนเกาะ

มองรายการนั้นเป็นจุดเริ่มต้น ไม่ใช่คำมั่นสัญญา สต็อกบนเครือข่าย OTP routing ใด ๆ เปลี่ยนตลอดทั้งวัน นี่คือเหตุผลที่ endpoint ราคารายงานความพร้อมใช้งานสดสำหรับแต่ละคู่บริการและประเทศ

คนที่ไม่ใช่นักพัฒนารันการทดสอบเดียวกันจากแดชบอร์ดได้อย่างไร?

ผู้จัดการผลิตภัณฑ์และเจ้าหน้าที่สนับสนุนไม่จำเป็นต้องใช้ API หลังจากลงชื่อเข้าใช้ ให้เปิด OTP Gateway เลือกแองกวิลลาและบริการ ตรวจราคาที่แสดงก่อนสั่ง แล้วยืนยัน เบอร์จะปรากฏพร้อมตัวนับถอยหลัง นำไปวางในแอป แล้วรหัสจะแสดงบนหน้าจอเดียวกันเมื่อ SMS มาถึง มีปุ่มยกเลิกอยู่ข้างคำสั่งซื้อหากแผนเปลี่ยน สำหรับงาน regression ที่ทำซ้ำได้ คู่มือการทดสอบ QA ของเราแสดงให้เห็นว่าทีมแบ่งการตรวจสอบด้วยมือและแบบอัตโนมัติอย่างไร

การแก้ปัญหา: รหัสของแองกวิลลาไม่มา

ลองตามนี้ก่อนเปิดตั๋วแจ้งปัญหา

• ปล่อยให้หน้าต่างเดินต่อไป activation เปิดอยู่ 20 นาที การสั่งเบอร์ที่สองหลังจากเบอร์แรกเพียงหนึ่งนาทีมีแต่ทำให้ความสนใจของคุณกระจาย
• ตรวจสอบการยอมรับ บางบริการปฏิเสธเบอร์เสมือนหรือใช้กฎความเสี่ยงของตัวเองกับเบอร์ใหม่ หากฟอร์มสมัครปฏิเสธเบอร์ทันที ให้ยกเลิกแล้วเลือกเส้นทางอื่น
• ลองใหม่ภายหลังหรือเปลี่ยนเส้นทาง ความพร้อมใช้งานบนเส้นทางเกาะเล็กเปลี่ยนไปได้ การลองใหม่ภายหลัง หรือทดสอบโฟลว์เดียวกันบนประเทศอื่น มักแก้ปัญหาได้
• หลีกเลี่ยงลูปถี่ ๆ การสั่งซ้ำเป็นลูปทำให้ใช้ rate limit หมด และอาจทำให้บริการเป้าหมายระแวงมากขึ้น ไม่ใช่น้อยลง
• ตรวจสอบเว็บฮุกของคุณ ยืนยันว่า handler ตรวจ X-OTPRoute-Signature และตอบกลับสำเร็จ คู่มือการตรวจสอบ HMAC ครอบคลุมการเปรียบเทียบแบบ constant-time และการตรวจ timestamp

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

เบอร์ระยะยาว กระเป๋าเงิน และใบแจ้งหนี้

แม้แองกวิลลาจะโทรด้วย +1 แต่ก็ไม่ได้อยู่ในผลิตภัณฑ์ Dedicated Numbers เบอร์ระยะยาวแบบสมัครใช้เองมีเฉพาะสหรัฐอเมริกาและแคนาดา เริ่มต้น $1.95/month พร้อมรับ SMS ขาเข้า ส่งต่อไปยังเว็บฮุก และโทรผ่านเบราว์เซอร์ ดูเบอร์เสมือน หากต้องการเบอร์แองกวิลลาที่ใช้ได้นาน โปรดอีเมลถึง [email protected] โดยขึ้นอยู่กับกฎระเบียบในพื้นที่ว่าจะจัดให้ได้หรือไม่

การเรียกเก็บเงินใช้กระเป๋าเงิน USD แบบเติมเงินล่วงหน้าเพียงใบเดียว ไม่มีค่ารายเดือนและไม่ต้องเลือกแพ็กเกจ เติมเงินด้วยบัตรหรือ USDT/USDC และจะมีใบแจ้งหนี้ PDF ส่งทางอีเมลทุกครั้งที่เติมเงิน ราคาปัจจุบันอยู่ในหน้าราคา OTP Route มีไว้สำหรับทดสอบและดำเนินงานผลิตภัณฑ์และบัญชีของคุณเอง ภายใต้ข้อกำหนดของแต่ละบริการและนโยบายการใช้งานที่ยอมรับได้ (Acceptable Use Policy) ของเรา

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

ฉันทดสอบโฟลว์สมัครสมาชิกของแอปสำหรับแองกวิลลาโดยไม่มีซิมในประเทศได้หรือไม่?

ได้ สั่งเบอร์ +1 264 แบบใช้ครั้งเดียวจาก OTP Gateway กรอกลงในแอปของคุณ แล้วอ่านรหัสในแดชบอร์ดหรือผ่าน API

OTP Route API ใช้ country id อะไรสำหรับแองกวิลลา?

แองกวิลลาคือ ai ส่งเป็นค่า country ในคำขอ prices และ activations

เบอร์ +1 264 ถูกมองเป็นเบอร์สหรัฐฯ หรือไม่?

ไม่ควร แม้ใช้รหัส +1 ร่วมกัน แต่รหัสพื้นที่ 264 เป็นของแองกวิลลา ดังนั้นการตรวจจับภูมิภาคต้องดูคำนำหน้าทั้งหมด

รหัสยืนยันของแองกวิลลาราคาเท่าไร?

รหัสเริ่มต้นที่ $0.20 ต่อรหัส จำนวนที่แน่นอนขึ้นกับบริการ และแสดงในแดชบอร์ดพร้อมส่งกลับจาก endpoint ราคาก่อนที่คุณจะสั่ง

จะเกิดอะไรขึ้นถ้าไม่มี SMS เข้าเบอร์?

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

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

ไม่สามารถสมัครใช้เองได้ เบอร์ระยะยาวเป็นผลิตภัณฑ์สำหรับสหรัฐอเมริกาและแคนาดา สำหรับที่อื่น โปรดอีเมลสอบถามทีมงาน

มีวิธีเชื่อมต่อการทดสอบของแองกวิลลาก่อนเติมเงินเข้ากระเป๋าเงินหรือไม่?

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

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