คู่มือแบบ API-first สำหรับรหัสยืนยันสวีเดน +46

ฉันเรียก endpoint ใดเพื่อรับ SMS OTP ของสวีเดน?

เริ่มด้วยคีย์ API จาก Developer console คีย์มี prefix or_live_ และใส่ในส่วนหัว Bearer เรียก https://otproute.com/api/v1 คุณถือได้สูงสุด 10 คีย์ ซึ่งช่วยให้แยก CI, staging และเครื่องของนักพัฒนาได้ง่าย country id ของสวีเดนคือ se

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

การเรียก GET /api/v1/balance ก่อนรันชุดทดสอบช่วยให้งานหยุดก่อนได้เมื่อกระเป๋าเงินเหลือน้อย เพดานคือ 300 คำขอต่อนาที ซึ่งเพียงพอสำหรับช่วง polling ไม่กี่วินาที ดูคู่มือการเชื่อมต่อ OTP APIสำหรับขั้นตอนโดยละเอียดของ SMS verification API นี้

ฉันตรวจสอบ webhook ก่อนเชื่อรหัส +46 ได้อย่างไร?

ลงทะเบียน endpoint ใน Developer console (สูงสุด 5 รายการต่อบัญชี) และสมัครรับ activation.sms_received, activation.expired และ activation.cancelled

ทุกการส่งมี X-OTPRoute-Signature: t=<unix>,v1=<hex> ตัวจัดการของคุณควร

• สร้างสตริง "<t>.<raw body>" ขึ้นใหม่จาก body ของคำขอที่ไม่ถูกแก้ไข
• คำนวณ HMAC-SHA256 ด้วย secret ของ endpoint นั้นและเปรียบเทียบกับ v1 ในเวลาคงที่
• ปฏิเสธ timestamp ที่อยู่นอกช่วงเผื่อที่สั้น เพื่อป้องกันการเล่นซ้ำ
• ใช้ activation id เป็นคีย์ในการทำงาน เพื่อไม่ให้การส่งซ้ำประมวลผลรหัสเดิมสองครั้ง

การ polling ยังเป็นทางสำรองที่ใช้ได้เมื่อไฟร์วอลล์บล็อกการเรียกขาเข้า บทความความปลอดภัยของ webhook ด้วย HMACครอบคลุมกรณีขอบ

หมายเลข +46 ยืนยันบริการใดได้บ้าง?

ปัจจุบันเส้นทางสวีเดนมีบริการมากกว่า 1,700 รายการ ตัวอย่างปัจจุบัน ได้แก่ WhatsApp, Telegram, Discord, Snapchat, LinkedIn, Microsoft & Outlook, Google (Gmail & YouTube), Uber, Netflix, Amazon, Signal, ChatGPT (OpenAI), Claude, eBay และ X (Twitter)

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

ควรทำให้หมายเลขสวีเดนเป็นมาตรฐานและแยกวิเคราะห์อย่างไร?

สวีเดนใช้ trunk prefix เป็น 0 หมายเลขมือถือที่เขียนในประเทศเป็น 07 ตามด้วยอีก 8 หลัก จะกลายเป็น +46 7 และเลข 8 หลักนั้นใน E.164 โดยตัดศูนย์ออก เก็บรูปแบบสากลนั้น และตรวจให้แน่ใจว่าการจัดการอินพุตตัดช่องว่าง ขีดกลาง และศูนย์นำหน้า ก่อนเติม +46 หมายเลข +46 สำหรับทดสอบเป็น fixture ที่ดีสำหรับการตรวจนี้ เพราะชาวสวีเดนมักพิมพ์รูปแบบท้องถิ่นด้วยความเคยชิน

เทมเพลต SMS ภาษาสวีเดนอาจมีตัวอักษร å, ä และ ö หากไปป์ไลน์ของคุณบันทึกข้อความดิบ ให้ยืนยันว่าจัดการข้อความ Unicode ได้เรียบร้อย และดึงรหัสด้วยรูปแบบตัวเลข แทนวลีภาษาอังกฤษเช่น "your code is" ตัวแยกวิเคราะห์เดียวกันจึงใช้ได้ไม่ว่าบริการจะเขียนเป็นภาษาสวีเดนหรืออังกฤษ

ทีมทดสอบที่นี่สำหรับการเปิดตัวในกลุ่มนอร์ดิก เพื่อตรวจข้อความภาษาสวีเดนในขั้นตอนเริ่มใช้งาน และสำหรับทีมซัพพอร์ตระดับภูมิภาคที่ดูแลบัญชีแทนธุรกิจ

ผู้ที่ไม่ใช่นักพัฒนาใช้แดชบอร์ดสำหรับสวีเดนได้ไหม?

ได้ เลือกสวีเดนและบริการ ตรวจราคาปัจจุบัน แล้วยืนยัน หมายเลข +46 จะปรากฏในรายการคำสั่งซื้อ วางลงในแอป และรหัสจะแสดงข้างๆ เมื่อบริการส่งมา ผู้จัดการผลิตภัณฑ์และเจ้าหน้าที่ซัพพอร์ตใช้เส้นทางนี้เพื่อตรวจขั้นตอนเดียวบนหมายเลขยืนยันสวีเดนโดยไม่ต้องแตะ API การตั้งค่าบัญชีใช้อีเมลและรหัส 6 หลักที่สมัครใช้งาน

ทำไมรหัส +46 อาจไม่มา และควรทำอย่างไร?

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

หากรหัสหาย ให้เวลาแก่ช่วงเวลานั้น แล้วลองใหม่ภายหลังหรือทดสอบผ่านเส้นทางบริการอื่น บางบริการปฏิเสธหมายเลขเสมือน และการปฏิเสธบนหน้าสมัครสมาชิกมักหมายถึงเรื่องนั้น ไม่ใช่ความผิดพลาดในการส่ง ให้หน่วงระหว่างการลองแทนการสั่งซ้ำในลูปถี่ๆ ตรรกะการกำหนดเส้นทาง OTP ที่ดีถือว่ารหัสที่หายไปเป็นสัญญาณให้รอหรือสลับ ไม่ใช่ให้ยิงถี่

สายเฉพาะ กระเป๋าเงิน และ sandbox สำหรับการทดสอบในสวีเดน

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

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

ทดสอบเฉพาะผลิตภัณฑ์ของคุณเอง เคารพข้อกำหนดของแต่ละบริการ และปฏิบัติตามนโยบายการใช้งานที่ยอมรับได้ของ OTP Route

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

country id ของสวีเดนใน OTP Route API คืออะไร?

คือ se ใช้ใน query string ของราคาและใน body ของ activation

ฉันเก็บหมายเลขสวีเดนโดยมี 0 นำหน้าหรือไม่?

ไม่ ตัดศูนย์ trunk ออกและบันทึกรูปแบบ E.164 ที่ขึ้นต้นด้วย +46 แสดงรูปแบบท้องถิ่นเฉพาะเมื่อส่วนติดต่อของคุณต้องการ

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

ได้ สั่งหมายเลข +46 สำหรับบริการ กรอกในแอปของคุณ และรับรหัสผ่าน webhook, polling หรือแดชบอร์ด

ตัวอักษรสวีเดนจะทำให้ตัวแยกวิเคราะห์ OTP ของฉันพังหรือไม่?

ไม่ควร หากคุณจับคู่ตัวเลขแทนคำ และจัดการข้อความเป็นข้อความ Unicode

คำสั่งซื้อ +46 ที่ล้มเหลวมีค่าใช้จ่ายเท่าไร?

ไม่มีเลย หากไม่มี SMS ภายใน 20 นาที หรือหลังยกเลิก เงินทั้งหมดจะกลับเข้ากระเป๋าเงิน

ฉันได้หมายเลขสวีเดนที่เป็นของฉันตลอดไปได้ไหม?

ไม่มีเป็นผลิตภัณฑ์แบบสั่งเอง หมายเลขระยะยาวมีให้ในสหรัฐฯ และแคนาดา อีเมลถึง [email protected] เพื่อสอบถามเรื่องสวีเดน

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

ขอโหมด sandbox สำหรับบัญชีพัฒนา ซึ่งส่งกลับหมายเลขและรหัสจำลองตั้งแต่ต้นจนจบ

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