เช็กลิสต์ก่อนเริ่มรับรหัสยืนยัน +372 ในเอสโตเนีย

ก่อนสั่งหมายเลข +372 ครั้งแรก ควรมีอะไรในเช็กลิสต์

รอบทดสอบที่ล้มเหลวส่วนใหญ่มีสาเหตุจากสิ่งที่ขาดไปก่อนจะขอหมายเลขด้วยซ้ำ ไล่ติ๊กรายการเหล่านี้ก่อน

• API key ที่สร้างใน Developer console ทุกคีย์ขึ้นต้นด้วย or_live_ และส่งเป็น Bearer token บัญชีหนึ่งมีได้ 10 ชุด จึงควรให้ CI runner มีคีย์ของตัวเอง
• webhook endpoint พร้อมเก็บ secret ไว้ฝั่งเซิร์ฟเวอร์ หากคุณอยากให้ระบบเรียกหาแทนการ poll แต่ละบัญชีมีได้ห้า endpoint
• id ที่ถูกต้อง เอสโตเนียคือ ee ในทุกคำขอ ส่วน service id มาจาก GET /api/v1/services
• การตรวจราคาสด เรียก GET /api/v1/prices?country=ee&service=<id> เพื่อให้งานรู้ต้นทุนก่อนตัดสินใจใช้เงินในกระเป๋า
• Sandbox หากยังอยู่ระหว่างต่อระบบ เมื่อร้องขอ บัญชีสำหรับพัฒนาสลับเป็นโหมด sandbox ได้ ซึ่งให้หมายเลขและรหัสจำลองตลอดขั้นตอนโดยไม่แตะยอดคงเหลือ
• งบอัตราเรียก API รับ 300 คำขอต่อนาทีต่อบัญชี ซึ่งมากพอ เว้นแต่ชุดทดสอบจะ poll อย่างไม่ระวัง

คู่มือการเชื่อมต่อ OTP API อธิบายแต่ละข้อลึกขึ้น

รันคำขอ Estonia OTP API ตั้งแต่ต้นจนจบอย่างไร

เมื่อเช็กลิสต์ครบแล้ว ลำดับการเรียกก็สั้น

1. POST /api/v1/activations พร้อมเนื้อหา {"service": "<id>", "country": "ee"} คำตอบจะมี activation id และหมายเลข +372 ที่ต้องกรอกในฟอร์มสมัครหรือเข้าสู่ระบบที่กำลังทดสอบ
2. สั่งให้แอปที่ทดสอบส่ง SMS ยืนยัน
3. รอรหัส โดยให้ endpoint ของคุณรับ activation.sms_received หรือเรียก GET /api/v1/activations/{id} ตามช่วงเวลาที่เหมาะสม
4. ส่งรหัสในแอปและบันทึกผลโดยอ้างอิง activation id
5. หากเส้นทางทดสอบเปลี่ยนและไม่ต้องใช้หมายเลขแล้ว ให้เรียก POST /api/v1/activations/{id}/cancel เพื่อปลดรายการที่กันไว้ทันที

สำหรับ webhook ให้อ่านส่วนหัว X-OTPRoute-Signature (t=<unix>,v1=<hex>) คำนวณ HMAC-SHA256 ของ <t>.<raw body> ด้วย secret ของ endpoint เปรียบเทียบแบบ constant-time และทิ้งคำขอที่ timestamp เก่า การรักษาความปลอดภัย webhook ของ OTP ด้วย HMAC มีตัวอย่าง handler ให้ดู ควรทำให้การเขียนข้อมูลเป็น idempotent บน activation id เพราะการลองส่งใหม่อาจส่งเหตุการณ์เดิมซ้ำสองครั้ง

บริการใดบ้างที่ส่งรหัสไปยังหมายเลขยืนยันของเอสโตเนียได้

ข้อมูลล่าสุดของเอสโตเนียแสดงบริการมากกว่า 1,700 รายการ เส้นทางยอดนิยมได้แก่ WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, LinkedIn, Microsoft & Outlook, Amazon, Discord, Signal, Uber, Airbnb และ ChatGPT (OpenAI)

สต็อกเปลี่ยนไปตลอดวัน เส้นทางที่ตอบสนองเมื่อเช้าอาจเหลือน้อยในช่วงเย็น จึงควรถือ GET /api/v1/countries และ endpoint ราคาเป็นแหล่งข้อมูลจริง แทนการเขียนรายการตายตัวลงใน fixture ของชุดทดสอบ

ควรเก็บและตรวจสอบหมายเลข +372 อย่างไร

เอสโตเนียเป็นหนึ่งในแผนการกำหนดหมายเลขที่จัดการง่าย และด้วยเหตุนี้ตัวตรวจสอบแบบหยาบ ๆ จึงมักพังกับที่นี่ ไม่มีรหัสนำหน้า trunk ที่ต้องตัดออก หมายเลขที่เขียนแบบในประเทศก็คือเลขชุดเดียวกับที่ต่อท้าย +372 หมายเลขมือถือมักขึ้นต้นด้วย 5 และยาวเจ็ดหรือแปดหลัก ดังนั้น regex ที่บังคับความยาวคงที่จะปฏิเสธข้อมูลที่ถูกต้อง

กฎปฏิบัติสำหรับฟอร์มและฐานข้อมูลของคุณ

• เก็บสตริง E.164 เต็ม เช่น +3725xxxxxxx และแยกเก็บข้อมูลดิบที่ผู้ใช้พิมพ์ไว้ หากต้องใช้ในงานซัพพอร์ต
• อย่าเติมเลขศูนย์นำหน้า เพราะไม่มีอะไรให้ตัดหรือเพิ่ม
• ทดสอบทั้งมือถือเจ็ดหลักและแปดหลักใน input mask ของคุณ

ข้อความยืนยันที่ส่งถึงผู้ใช้ชาวเอสโตเนียมักมาเป็นภาษาเอสโตเนีย แม้หลายแอปจะใช้ภาษาตามบัญชีหรืออุปกรณ์ และเทมเพลตภาษารัสเซียหรืออังกฤษก็พบได้บ่อย หากผลิตภัณฑ์ของคุณมีภาษาเอสโตเนีย ให้ตรวจว่าตัวอักษรอย่าง õ, ä, ö และ ü รอดตลอดทางจากเทมเพลตถึงเครื่องรับ

ทำไมทีมจึงทดสอบขั้นตอนสมัครด้วยหมายเลขเอสโตเนีย

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

เหตุผลทั่วไปที่หัวหน้า QA ขอหมายเลข +372 เพื่อทดสอบ

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

ดูการทดสอบ QA เพื่อดูว่าทีมต่าง ๆ นำการตรวจสอบเหล่านี้เข้ารอบการปล่อยอย่างไร

ควรตรวจอะไรเมื่อรหัสไม่ปรากฏ

แก้ปัญหาตามลำดับ แทนที่จะสั่งหมายเลขซ้ำไปเรื่อย ๆ

1. ปล่อยให้ช่วงเวลาทำงานครบ การเปิดใช้งานเปิดค้างไว้ 20 นาที และบางบริการมีคิวข้อความ
2. ยืนยันว่าบริการรับหมายเลขเสมือน บางบริการปฏิเสธตามนโยบาย นี่คือเหตุผลที่มีการคืนเงิน
3. ดูสถานะสุดท้าย เหตุการณ์ activation.expired หรือสถานะหมดอายุจากการเรียก GET หมายความว่าไม่มี SMS เข้ามา และเงินกลับเข้ากระเป๋าแล้ว
4. ลองใหม่อย่างอดทน ลองอีกครั้งภายหลัง หรือลองเส้นทางอื่นของบริการเดียวกัน แทนการสั่งซ้ำถี่ ๆ ในลูป
5. ตรวจตัวกระตุ้นของคุณเอง การทดสอบที่ไม่เคยขอ SMS จริงจะดูเหมือนรหัสที่หายไปทุกประการ

บทความการลดความล้มเหลวในการส่ง OTP ระบุสาเหตุอื่นที่ควรตัดออก

เก็บหมายเลขเอสโตเนียไว้ใช้ระยะยาวได้ไหม และคิดเงินอย่างไร

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

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

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

ทดสอบขั้นตอนสมัครใช้งานของแอปในเอสโตเนียโดยไม่มีซิมในพื้นที่ได้ไหม

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

country id ของเอสโตเนียใน OTP Route API คืออะไร

ใช้ ee เป็นค่า country ในคำขอเปิดใช้งานและตรวจราคา

หมายเลขโทรศัพท์เอสโตเนียมีรหัสนำหน้า trunk ที่ต้องตัดออกหรือไม่

ไม่มี เอสโตเนียไม่มีรหัสนำหน้า trunk เลขในประเทศจึงต่อท้าย +372 ได้โดยตรง

ถ้ารหัสของเอสโตเนียไม่มา ฉันถูกเรียกเก็บเงินไหม

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

ผู้ที่ไม่ใช่นักพัฒนาสั่งหมายเลขยืนยันของเอสโตเนียได้ไหม

ได้ ในแดชบอร์ด เลือกเอสโตเนียและบริการ ยืนยันราคาที่แสดง คัดลอกหมายเลขไปใส่ในแอป แล้วรอให้รหัสปรากฏบนหน้าจอเดียวกัน

ซ้อมการเชื่อมต่อของเอสโตเนียก่อนใช้เงินจริงได้ไหม

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

กฎใดบ้างที่ใช้กับวิธีที่ฉันใช้หมายเลขเหล่านี้

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

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