รับรหัส SMS OTP ของนิวซีแลนด์ผ่าน API หรือแดชบอร์ด

หมายเลขชั่วคราว +64 หรือสายระยะยาว: ควรเลือกแบบไหน?

การเลือกผลิตภัณฑ์ให้ถูกตั้งแต่แรกช่วยลดงานแก้ภายหลัง

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

เลือก Dedicated Number เมื่อบัญชีเดียวกันต้องล็อกอินซ้ำในอีกหลายสัปดาห์ หรือทีมใช้หมายเลขกู้คืนบัญชีร่วมกัน สายระยะยาวเหล่านี้มีให้เฉพาะในสหรัฐอเมริกาและแคนาดา เริ่มต้น $1.95/เดือน โดย SMS ขาเข้าจะถูกส่งต่อเป็นเหตุการณ์ number.sms_received

สำหรับนิวซีแลนด์เอง ไม่มีหมายเลขระยะยาวแบบสั่งเองได้ หากกรณีของคุณต้องการ โปรดอีเมลถึง [email protected] คำตอบขึ้นอยู่กับกฎระเบียบในพื้นที่และอาจเป็นปฏิเสธ รายละเอียดเรื่องการโทร SMS ขาออก และเงื่อนไขการต่ออายุของสายในอเมริกาเหนือเหล่านั้นอยู่ในหน้าหมายเลขเสมือน

ทำไมทีมผลิตภัณฑ์จึงทดสอบการสมัครสมาชิกในนิวซีแลนด์?

นิวซีแลนด์เป็นตลาดซอฟต์ลอนช์ยอดนิยมสำหรับแอปภาษาอังกฤษ เพราะกลุ่มผู้ใช้เล็กกว่า ภาษาคุ้นเคย และเขตเวลาที่มาก่อนใคร ทำให้เหมาะกับการดูการเริ่มใช้งานจริงก่อนเปิดตัวในวงกว้าง นั่นหมายความว่าขั้นตอนยืนยัน +64 มักเป็นเส้นทางโปรดักชันแรกที่ตลาดใหม่ได้เห็น และควรมีกรณีทดสอบของตัวเอง

สิ่งที่ควรครอบคลุมมีดังนี้

• ภาษา ภาษาอังกฤษ ภาษาเมารี (te reo Māori) และภาษามือนิวซีแลนด์เป็นภาษาทางการ บริการส่วนใหญ่ส่งรหัสเป็นภาษาอังกฤษ แต่หากเทมเพลตของคุณเองใช้คำภาษาเมารีที่มีเครื่องหมาย macron (ā, ō, ū) อักขระเหล่านี้อยู่นอก GSM-7 และทำให้ SMS เปลี่ยนเป็น UCS-2 ซึ่งแต่ละเซกเมนต์จะสั้นลง
• ขอบเขตของเวลา นิวซีแลนด์เป็นหนึ่งในที่แรกๆ ที่เข้าสู่วันใหม่ ตรรกะการหมดอายุและการจำกัดอัตราที่อิงวันที่จึงอาจทำงานต่างออกไปสำหรับผู้ใช้ในท้องถิ่น
• ความเหมาะสมกับตลาด บัญชี QA ที่ยืนยันด้วยหมายเลขท้องถิ่นจะทดสอบตรรกะระดับประเทศแบบเดียวกับที่ผู้ใช้ชาวกีวีของคุณจะเจอ

สำหรับรูปแบบการคั่นก่อนปล่อยเวอร์ชันที่สร้างจากการตรวจสอบเช่นนี้ ดูบันทึกเรื่องการทดสอบ QAของเรา

ควรจัดเก็บและทำให้หมายเลขมือถือ +64 เป็นรูปแบบมาตรฐานอย่างไร?

นิวซีแลนด์ใช้ trunk prefix เป็น 0 หมายเลขมือถือที่เขียนแบบในประเทศว่า 021 123 4567 จะกลายเป็น +64211234567 ในรูปแบบ E.164 โดยตัด 0 ตัวหน้าออก แล้วเติม +64 ช่วงเลขมือถือขึ้นต้นด้วย 2 เมื่อตัดศูนย์ออกแล้ว และความยาวไม่แน่นอน ดังนั้นอย่าเขียนจำนวนหลักตายตัวลงในโค้ด

กฎเชิงปฏิบัติสำหรับสคีมาของคุณ

• เก็บสตริง E.164 มาตรฐานเพียงรูปแบบเดียว และจัดรูปแบบเฉพาะตอนแสดงผล
• ยอมรับข้อมูลที่มีช่องว่าง ขีดกลาง หรือศูนย์นำหน้า แล้วทำให้เป็นมาตรฐานด้วยไลบรารีแยกวิเคราะห์หมายเลขโทรศัพท์ที่มีการดูแลอยู่
• เพิ่ม fixture สำหรับการเขียนทั้งแบบในประเทศและระหว่างประเทศ รวมถึงหมายเลขที่ผู้ใช้วางมาโดยมี +64 และ 0 อยู่ด้วยกัน

แอปใดบ้างที่ส่งรหัสไปยังหมายเลขนิวซีแลนด์บน OTP Route?

เส้นทาง +64 รองรับบริการมากกว่า 800 รายการ จากข้อมูลล่าสุด บริการที่ใช้บ่อย ได้แก่ Google (Gmail & YouTube), WhatsApp, Telegram, Facebook, Instagram, TikTok, ChatGPT (OpenAI), Claude, Microsoft & Outlook, Amazon, Discord, Snapchat, LinkedIn, Uber และ Netflix

เนื่องจากความพร้อมใช้งานเป็นแบบเรียลไทม์ ให้เรียก GET /api/v1/countries และ GET /api/v1/services ตอนเริ่มการรันแต่ละครั้ง แทนการแคชรายการไว้หลายสัปดาห์ หากบริการใดมีน้อยบนเส้นทาง +64 เส้นทางออสเตรเลียที่อยู่ใกล้เคียงมักเป็นทางเลือกสำรองสำหรับการเปรียบเทียบในภาษาอังกฤษ

ลำดับขั้นตอนของ OTP API นิวซีแลนด์เป็นอย่างไร?

ทุกการเรียก +64 ส่งไปที่ https://otproute.com/api/v1 พร้อมคีย์ Bearer แบบ or_live_ ที่ออกให้ใน Developer console ลำดับขั้นตอนมีดังนี้

1. อ่านราคาปัจจุบันด้วย GET /api/v1/prices?country=nz&service=uber
2. สร้าง activation ด้วย POST /api/v1/activations โดยมี body เป็น {"service": "uber", "country": "nz"}
3. รับรหัสด้วยการ poll GET /api/v1/activations/{id} หรือให้ activation.sms_received ส่งมาที่ webhook ของคุณ activation.expired และ activation.cancelled จะบอกว่าถึงเวลาเก็บกวาด
4. ยกเลิกคำสั่งซื้อที่ไม่ใช้ด้วย POST /api/v1/activations/{id}/cancel และติดตามยอดเงินด้วย GET /api/v1/balance

สำหรับ webhook ให้ตรวจสอบ X-OTPRoute-Signature โดยคำนวณ HMAC-SHA256 ของ <t>.<raw body> ด้วย secret ของ endpoint ปฏิเสธ timestamp ที่เก่าเกินไป และทำให้ตัวจัดการเป็น idempotent ตาม id ของ activation เพื่อให้การส่งซ้ำไม่ก่อปัญหา คู่มือการเชื่อมต่อมีขั้นตอนโดยละเอียดกว่านี้ ขีดจำกัดคือ 300 คำขอต่อนาทีต่อบัญชี

ผู้ที่ไม่ใช่นักพัฒนาสั่งหมายเลขยืนยันนิวซีแลนด์ได้หรือไม่?

ได้แน่นอน ในแดชบอร์ด ให้เลือกนิวซีแลนด์ เลือกบริการ ตรวจสอบราคาที่แสดง แล้วยืนยัน หมายเลข +64 จะปรากฏในคำสั่งซื้อ ให้กรอกลงในแอป ขอ SMS แล้วรหัสจะแสดงบนการ์ดเดียวกันเมื่อมาถึง ทุกอย่างเกิดขึ้นภายในช่วงเวลา 20 นาที จึงควรเปิดแอปปลายทางรอไว้ก่อนสั่ง

ถ้ารหัส +64 ไม่มาล่ะ?

ให้เวลาเต็ม 20 นาทีก่อน เพราะบางผู้ส่งหน่วงหรือรวมส่ง SMS หากยังว่างอยู่ บริการอาจปฏิเสธหมายเลขเสมือน หรือเส้นทางนั้นอาจคับคั่ง ให้ลองใหม่ภายหลังหรือทดสอบกับเส้นทางบริการอื่น แทนการสั่งซ้ำติดๆ กัน คำสั่งซื้อที่ไม่มีการตอบกลับ และที่คุณยกเลิก จะได้รับเงินคืนเข้ากระเป๋าเงินโดยอัตโนมัติ การเรียกเก็บเงินเป็นแบบจ่ายตามการใช้งานจากกระเป๋าเงิน USD แบบเติมเงินล่วงหน้า เติมเงินด้วยบัตรหรือ USDT/USDC พร้อมใบแจ้งหนี้ PDF ทุกครั้ง ไม่มีค่ารายเดือน และมีโหมด sandbox ตามคำขอสำหรับการทดลองรัน OTP Route ใช้สำหรับบัญชีและผลิตภัณฑ์ที่ถูกต้องตามกฎหมายของคุณเอง ภายใต้ข้อกำหนดของแต่ละบริการและนโยบายการใช้งานที่ยอมรับได้ของเรา

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

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

ได้ สั่งหมายเลข +64 บน OTP Gateway ใช้ในแบบฟอร์มสมัครสมาชิกของคุณ แล้วอ่านรหัสในแดชบอร์ดหรือผ่าน API

ต้องเก็บเลข 0 ไว้ตอนบันทึกหมายเลขมือถือนิวซีแลนด์หรือไม่?

ไม่ต้อง เลข 0 ที่เป็น trunk จะถูกตัดออกใน E.164 ดังนั้น 021 123 4567 จะถูกเก็บเป็น +64211234567

country id ของ API สำหรับนิวซีแลนด์คืออะไร?

คือ nz ใช้ในการค้นหาราคาและใน body ของคำขอ activation

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

ราคาเริ่มต้นที่ $0.20 ต่อรหัส และขึ้นกับบริการ แดชบอร์ดและ GET /api/v1/prices จะแสดงราคาที่แน่นอนก่อนที่คุณจะสั่ง

ฉันเช่าหมายเลขนิวซีแลนด์ได้สักสองสามเดือนไหม?

ไม่มีสาย +64 ระยะยาวแบบสั่งเองได้ Dedicated Number เป็นผลิตภัณฑ์สำหรับสหรัฐฯ และแคนาดา และคุณสามารถอีเมลถึง [email protected] เพื่อสอบถามเกี่ยวกับประเทศอื่น

การ polling หรือ webhook เหมาะกว่าสำหรับรับรหัส +64?

การ polling ง่ายกว่าสำหรับสคริปต์เดียว ส่วน webhook ที่ลงลายเซ็นขยายขนาดได้ดีกว่าเมื่อมีงานทดสอบรันขนานกันจำนวนมาก ทั้งสองแบบให้รหัสเดียวกัน

ทุกแอปจะรับหมายเลขนิวซีแลนด์ของ OTP Route หรือไม่?

ไม่จำเป็น บางบริการปฏิเสธหมายเลขเสมือน นั่นคือเหตุผลที่คำสั่งซื้อที่ไม่มี SMS จะได้รับเงินคืนโดยอัตโนมัติ

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