รับรหัส SMS OTP ของสาธารณรัฐเช็กผ่าน endpoint, webhook หรือแดชบอร์ด

Czech Republic OTP API ใช้ endpoint ใดบ้าง?

ทุกอย่างทำงานกับ https://otproute.com/api/v1 โดยใช้ Bearer key ที่ขึ้นต้นด้วย or_live_ คุณสร้าง key ได้ใน Developer console และบัญชีหนึ่งมีได้สูงสุด 10 key ทำให้แยกข้อมูลรับรองสำหรับ staging, CI และแล็ปท็อปในเครื่องได้ และเพิกถอนแยกกันได้ ขีดจำกัดอัตราคือ 300 requests ต่อนาทีต่อบัญชี

การรันกับเบอร์ +420 โดยทั่วไปเป็นดังนี้

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

การเรียก GET /api/v1/balance ก่อนเริ่มชุดทดสอบขนาดใหญ่เป็นวิธีราคาถูกในการหยุดตั้งแต่ต้นเมื่อยอดเงินในกระเป๋าต่ำ เอกสารอ้างอิงฉบับเต็มอยู่ใน เอกสาร

ฉันจะตรวจสอบ webhook สำหรับ activation ของ +420 ได้อย่างไร?

Webhook ช่วยให้ไม่ต้อง poll และเหมาะกับ test runner ที่รันขนานกัน ชี้หนึ่งใน endpoint ของคุณ (Developer console อนุญาต 5 รายการต่อบัญชี) ไปยังขั้นตอนของเช็ก และ subscribe activation.sms_received, activation.expired และ activation.cancelled

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

ถือว่า event ผูกกับ activation id และทำให้ handler เป็น idempotent คือเมื่อมีการส่งซ้ำ ควรพบว่า activation ถูกทำเครื่องหมายเสร็จแล้ว และตอบสำเร็จเฉยๆ การ poll GET /api/v1/activations/{id} ยังเป็นทางสำรองที่ใช้ได้สำหรับสคริปต์ที่รันในที่ที่ไม่มี public endpoint

บริการใดบ้างที่ส่งรหัสไปยังเบอร์เช็กได้?

เส้นทางของเช็กในปัจจุบันครอบคลุมบริการมากกว่า 1,700 รายการ ชื่อยอดนิยมใน snapshot ล่าสุด ได้แก่ WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Microsoft & Outlook, LinkedIn, Discord, Uber, Airbnb, Signal, Viber และ ChatGPT (OpenAI)

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

ควรเก็บและ parse เบอร์ยืนยันของเช็กอย่างไร?

แผนการกำหนดเลขหมายของเช็กเป็นแบบปิด เบอร์ประจำชาติมีเก้าหลักและไม่มี trunk prefix ดังนั้นรูปแบบในประเทศกับรูปแบบสากลต่างกันเพียง +420 ที่นำหน้า ทำให้การ normalize ง่ายกว่าหลายตลาด แต่ฟอร์มก็ยังได้รับช่องว่าง คำนำหน้าสากล 00420 หรือเลขเก้าหลักเปล่าๆ ให้ลบตัวคั่น แปลง 00 เป็น + เติม +420 เมื่อไม่มี และเก็บผลลัพธ์เป็น E.164

รหัสจากแอปที่ให้บริการผู้ใช้ชาวเช็กมักมาเป็นภาษาเช็กหรืออังกฤษ ข้อความภาษาเช็กมีเครื่องหมายกำกับเสียง เช่น háček และ čárka และผู้ส่งบางรายตัดออกเพื่อให้ข้อความอยู่ในชุดอักขระธรรมดา ตัว parser จึงควรมองหากลุ่มตัวเลขแทนที่จะจับคู่ทั้งประโยค

ทีมใช้เบอร์ +420 เพื่อทดสอบเมื่อเปิดตัวผลิตภัณฑ์สำหรับลูกค้าชาวเช็ก ตรวจข้อความ onboarding ภาษาเช็ก หรือยืนยันว่าขั้นตอนสมัครของภูมิภาคนี้รับเบอร์ที่ไม่มีเลขศูนย์นำหน้า หน้า QA testing สรุปวิธีที่ทีมจัดโครงสร้างการรันเหล่านี้

จะเกิดอะไรขึ้นเมื่อรหัสของเช็กไม่มา?

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

• ปล่อยให้หน้าต่างเวลาเดินจนจบก่อนสรุปว่าความพยายามนั้นล้มเหลว
• ตรวจว่าบริการที่คุณกำลังทดสอบรับเบอร์เสมือนหรือไม่
• ลองใหม่ภายหลัง หรือลองเส้นทางประเทศอื่นที่บริการนั้นรองรับ
• เว้นระยะระหว่างความพยายาม การสั่งซ้ำรัวๆ ใช้ rate limit เปล่าๆ และแทบไม่ช่วย
• บันทึก activation id ไว้กับทุกความล้มเหลว เพื่อให้เห็นรูปแบบข้ามการรัน

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

ได้ หลังจาก สมัครใช้งาน ด้วยอีเมลและรหัสอีเมล 6 หลัก (หรือ Google sign-in) ให้เปิด OTP Gateway เลือกบริการและสาธารณรัฐเช็ก ตรวจราคาที่แสดง แล้วสั่งซื้อ เบอร์ยืนยันของเช็กจะปรากฏทันที นำไปวางในแอป แล้วรหัสจะแสดงบนหน้าจอเดียวกันเมื่อมาถึง การยกเลิกจากแดชบอร์ดคืนยอดเข้ากระเป๋าเงินเช่นเดียวกับการเรียก API

มีเบอร์เช็กแบบระยะยาวไหม และการเรียกเก็บเงินทำอย่างไร?

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

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

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

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

ได้ สั่งเบอร์ +420 จาก OTP Gateway สำหรับบริการที่คุณกำลังทดสอบ กรอกในแอปของคุณ แล้วอ่านรหัสจากแดชบอร์ด API หรือ webhook

country id ของสาธารณรัฐเช็กใน OTP Route API คืออะไร?

ใช้ cz ในฟิลด์ country ของ POST /api/v1/activations และในการค้นหาราคา

รหัสยืนยันของเช็กราคาเท่าไร?

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

เบอร์เช็กต้องมีเลขศูนย์นำหน้าไหม?

ไม่ต้อง เบอร์เช็กไม่มี trunk prefix ให้เก็บเป็น +420 ตามด้วยเลขประจำชาติเก้าหลัก

activation ของ +420 เปิดอยู่นานเท่าไร?

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

OTP routing ไปยังสาธารณรัฐเช็กเหมาะกับการสร้างบัญชีจำนวนมากไหม?

ไม่ OTP Route มีไว้สำหรับทดสอบผลิตภัณฑ์ของคุณเองและดำเนินการบัญชีที่ถูกต้องตามกฎหมายของคุณเอง ให้ผูกทุก activation +420 กับผลิตภัณฑ์หรือบัญชีของคุณเอง ภายใต้ข้อกำหนดของแต่ละบริการและนโยบายการใช้งานที่ยอมรับได้ (Acceptable Use Policy) ของ OTP Route

ฉันเก็บเบอร์เช็กเดิมไว้ล็อกอินภายหลังได้ไหม?

ไม่ใช่ในรูปแบบ self-serve Dedicated Numbers ระยะยาวมีเฉพาะในสหรัฐอเมริกาและแคนาดา และคุณสามารถส่งอีเมลถึงทีมซัพพอร์ตเพื่อสอบถามเกี่ยวกับตลาดอื่น

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