รหัสยืนยัน +351 แบบเขียนโปรแกรมสำหรับการเปิดตัวในโปรตุเกส

การยืนยันทาง +351 หนึ่งรอบต้องเรียกใช้ endpoint ใดบ้าง

Base URL คือ https://otproute.com/api/v1 และทุกคำขอต้องแนบ Bearer key ที่ขึ้นต้นด้วย or_live_ รหัสประเทศ (country id) ของโปรตุเกสคือ pt

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

ขีดจำกัดของบัญชีคือ API key 10 ชุด, เว็บฮุก endpoint 5 รายการ และ 300 คำขอต่อนาที ดูสคีมาฉบับเต็มได้ที่ เอกสารอ้างอิง API

เว็บฮุกที่ลงลายเซ็นส่งรหัสโปรตุเกสมายังบริการของเราอย่างไร

ลงทะเบียน endpoint แบบ HTTPS ใน Developer console แล้วสมัครรับเหตุการณ์ activation.sms_received, activation.expired และ activation.cancelled ทุกคำขอ POST จะมี X-OTPRoute-Signature: t=<unix>,v1=<hex> มาด้วย

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

เส้นทางโปรตุเกสเปิดให้บริการอะไรบ้าง

ข้อมูลล่าสุดแสดงบริการของโปรตุเกสมากกว่า 2,000 รายการ บริการที่ใช้บ่อยได้แก่ WhatsApp, Telegram, Airbnb, Uber, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LinkedIn, Microsoft & Outlook, Amazon, Netflix, Discord และ Signal

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

ทำไมทีมผลิตภัณฑ์จึงทดสอบกับหมายเลขโปรตุเกส

โปรตุเกสมักปรากฏเป็นตลาดแรก ๆ ในแผนขยายสู่ยุโรป ลิสบอนและปอร์โตเป็นที่ตั้งของทีมผลิตภัณฑ์และวิศวกรรมจำนวนมาก และหลายบริษัทใช้โปรตุเกสเป็นฐานในยุโรป นอกจากนี้ยังมีเหตุผลด้านการปรับภาษา เพราะโปรตุเกสแบบยุโรป (pt-PT) ต่างจากโปรตุเกสแบบบราซิลทั้งการสะกด คำศัพท์ และรูปการเรียกขาน โฟลว์ที่แปลสำหรับบราซิลจึงอาจอ่านแล้วแปลกสำหรับผู้ใช้ในโปรตุเกส การยืนยัน +351 จริงช่วยให้ผู้ตรวจทานเห็นข้อความ pt-PT, SMS ที่เข้ามา และหน้าจอโดยรอบได้พร้อมกัน

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

หมายเลข +351 มีรูปแบบและการจัดเก็บอย่างไร

โปรตุเกสไม่มี trunk prefix หมายเลขมีเก้าหลักและกดเหมือนกันทั้งในประเทศและในรูปแบบสากลหลัง +351 เบอร์มือถือขึ้นต้นด้วย 9 ส่วนเบอร์บ้านตามพื้นที่ขึ้นต้นด้วย 2 ให้เก็บในรูป E.164 ปฏิเสธสิ่งที่ไม่ใช่เก้าหลักหลังรหัสประเทศ และลบช่องว่างที่ผู้ใช้พิมพ์แยกเป็นกลุ่มละสามหลัก

รหัสที่เข้ามามักเป็นภาษาโปรตุเกสหรืออังกฤษ ขึ้นอยู่กับผู้ส่งและภาษาที่ตั้งไว้ในบัญชี ตัวดึงรหัสของคุณควรมองหาตัวเลข ไม่ใช่วลีตายตัว

เพื่อนร่วมทีมทำโดยไม่เขียนโค้ดได้ไหม และหาก SMS ไม่เข้าควรทำอย่างไร

ในแดชบอร์ด เปิด OTP Gateway เลือกโปรตุเกสและบริการ ตรวจราคาจริง แล้วสั่งซื้อ วางหมายเลขลงในแอปของคุณ แล้วรอรหัสในหน้ากิจกรรม (activation)

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

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

มีหมายเลขประจำสำหรับโปรตุเกสไหม และการเรียกเก็บเงินเป็นอย่างไร

OTP Route ไม่ขายหมายเลขเฉพาะแบบบริการตนเองในโปรตุเกส Dedicated Virtual Numbers มีเฉพาะสหรัฐอเมริกาและแคนาดา เริ่มต้น $1.95/month หากต้องการสาย +351 ระยะยาว ส่งอีเมลถึง [email protected] โดยทราบไว้ว่าความพร้อมขึ้นอยู่กับกฎระเบียบท้องถิ่นและไม่มีการรับประกัน ดูความแตกต่างระหว่างหมายเลขชั่วคราวกับหมายเลขเฉพาะ

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

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

country id ของโปรตุเกสใน OTP Route API คืออะไร

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

หมายเลขโทรศัพท์โปรตุเกสใช้ trunk prefix เช่นเลข 0 นำหน้าไหม

ไม่ใช้ หมายเลขโปรตุเกสมีเก้าหลักโดยไม่มี trunk prefix รูปแบบ E.164 จึงเป็น +351 ตามด้วยเก้าหลักนั้น

ทดสอบโฟลว์ onboarding แบบ pt-PT โดยไม่มีซิมโปรตุเกสได้ไหม

ได้ หมายเลข +351 สำหรับการทดสอบจาก OTP Gateway จะรับรหัส ซึ่งคุณอ่านได้ในแดชบอร์ดหรือผ่าน API

หมายเลขยืนยันของโปรตุเกสราคาเท่าไร

เริ่มต้น $0.20 ต่อรหัส ราคาที่แน่นอนขึ้นอยู่กับบริการและแสดงให้เห็นก่อนสั่งซื้อ

ถ้า activation +351 ไม่ได้รับอะไรเลย ฉันต้องจ่ายไหม

ไม่ต้อง activation ที่หมดเวลาหรือถูกยกเลิกจะได้รับเงินคืนเต็มจำนวนเข้ากระเป๋า

เช่าหมายเลขโปรตุเกสไว้ล็อกอินต่อเนื่องได้ไหม

ไม่ได้แบบบริการตนเอง หมายเลขระยะยาวเป็นผลิตภัณฑ์ของสหรัฐฯ และแคนาดา หากต้องการสาย +351 ให้อีเมลถึงฝ่ายสนับสนุน

ควรโพลลิงหรือใช้เว็บฮุกสำหรับรหัสโปรตุเกส

เว็บฮุกขยายขนาดได้ดีกว่าสำหรับงานแบบขนาน ส่วนการโพลลิง GET /api/v1/activations/{id} เหมาะกับ runner ที่รับทราฟฟิกขาเข้าไม่ได้

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