Nhận mã OTP SMS của Cộng hòa Séc qua endpoint, webhook hoặc bảng điều khiển

API OTP Cộng hòa Séc dùng những endpoint nào?

Mọi thứ chạy trên https://otproute.com/api/v1 với khóa Bearer có tiền tố or_live_. Bạn tạo khóa trong Developer console, một tài khoản giữ được tối đa 10 khóa, nhờ đó dễ cấp cho staging, CI và máy cá nhân các thông tin xác thực riêng, có thể thu hồi độc lập. Giới hạn tốc độ là 300 yêu cầu mỗi phút cho mỗi tài khoản.

Một lượt chạy +420 điển hình như sau:

1. Lấy GET /api/v1/countries và GET /api/v1/services mỗi lần triển khai một lần rồi lưu bộ nhớ đệm. Id quốc gia của Séc là cz.
2. Hỏi GET /api/v1/prices?country=cz&service=<id> để biết giá hiện tại của tuyến định dùng; giá thay đổi theo dịch vụ và theo lượng hàng sẵn có.
3. Tạo kích hoạt bằng POST /api/v1/activations với phần thân JSON {"service": "<id>", "country": "cz"}. Phản hồi trả về id kích hoạt và số để bạn nhập vào biểu mẫu đăng ký đang kiểm thử.
4. Chờ mã, hoặc qua webhook, hoặc đọc GET /api/v1/activations/{id} ở khoảng cách vừa phải.
5. Nếu bài kiểm thử bị hủy, hãy giải phóng số bằng POST /api/v1/activations/{id}/cancel để khoản giữ chỗ quay về ví ngay.

Gọi GET /api/v1/balance trước một bộ test lớn là cách rẻ để dừng sớm khi ví sắp hết tiền. Tài liệu tham chiếu đầy đủ nằm trong tài liệu.

Làm sao xác minh webhook cho các kích hoạt +420?

Webhook loại bỏ nhu cầu thăm dò và phù hợp với các trình chạy test song song. Trỏ một endpoint của bạn (Developer console cho phép 5 endpoint mỗi tài khoản) vào luồng Séc và đăng ký nó với activation.sms_received, activation.expired và activation.cancelled.

Mỗi yêu cầu mang header X-OTPRoute-Signature dạng t=<unix>,v1=<hex>. Dựng lại chuỗi <t>.<raw body> từ đúng các byte gốc của yêu cầu, tính HMAC-SHA256 bằng bí mật của endpoint đó, so sánh kết quả với v1 theo thời gian không đổi, và bỏ mọi yêu cầu có dấu thời gian quá cũ để là một lần gửi mới. Hướng dẫn của chúng tôi về bảo mật webhook OTP bằng HMAC đi qua từng dòng của một handler.

Hãy coi sự kiện được khóa theo id kích hoạt và làm handler có tính idempotent: một lần gửi lại sẽ thấy kích hoạt đã được đánh dấu hoàn tất và chỉ cần trả về thành công. Thăm dò GET /api/v1/activations/{id} vẫn là phương án dự phòng hợp lệ cho các script chạy ở nơi không có endpoint công khai.

Dịch vụ nào có thể gửi mã tới số Séc?

Tuyến Séc hiện bao phủ hơn 1.700 dịch vụ. Các tên phổ biến trong bản chụp mới nhất gồm WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Microsoft & Outlook, LinkedIn, Discord, Uber, Airbnb, Signal, Viber và ChatGPT (OpenAI).

Danh sách này không cố định. Lượng hàng thay đổi trong ngày, nên mã của bạn cần đọc tình trạng khả dụng từ API tại thời điểm chạy thay vì từ một bảng mã cứng. Nếu một dịch vụ bạn cần vắng mặt ở một thời điểm, nó có thể xuất hiện lại sau, hoặc một tuyến lân cận ở Trung Âu có thể phù hợp với ca kiểm thử.

Nên lưu và phân tích số xác minh của Séc như thế nào?

Việc đánh số của Séc là khép kín: số quốc gia có chín chữ số và không có tiền tố nội hạt, nên dạng trong nước và dạng quốc tế chỉ khác nhau ở +420 đứng trước. Điều đó khiến việc chuẩn hóa đơn giản hơn nhiều thị trường khác, nhưng biểu mẫu vẫn nhận dấu cách, tiền tố quốc tế 00420 hoặc chín chữ số trần. Hãy bỏ dấu phân cách, đổi 00 thành +, thêm +420 khi thiếu, rồi lưu kết quả theo E.164.

Mã từ các ứng dụng hướng tới người Séc thường đến bằng tiếng Séc hoặc tiếng Anh. Tiếng Séc có dấu phụ như háček và čárka, và một số bên gửi bỏ dấu để giữ tin nhắn trong bộ ký tự thường, nên bộ phân tích cần tìm nhóm chữ số thay vì khớp cả câu.

Các đội dùng số +420 để kiểm thử khi ra mắt sản phẩm cho khách hàng Séc, kiểm tra nội dung onboarding tiếng Séc, hoặc xác nhận một luồng đăng ký khu vực chấp nhận số không có số 0 đứng đầu. Trang kiểm thử QA phác thảo cách các đội tổ chức những lượt chạy này.

Cần làm gì khi mã Séc không bao giờ về?

Một số dịch vụ từ chối số ảo, và một số tuyến chậm hơn vào những giờ nhất định. Mã bị lỡ không tốn gì: nếu không có SMS nào về trong cửa sổ 20 phút, hoặc bạn hủy trước, toàn bộ số tiền được hoàn về ví tự động.

• Hãy để hết cửa sổ rồi mới kết luận lần thử thất bại.
• Kiểm tra xem dịch vụ bạn đang kiểm thử có chấp nhận số ảo hay không.
• Thử lại sau, hoặc thử tuyến quốc gia khác mà dịch vụ hỗ trợ.
• Giãn cách giữa các lần thử; đặt lại liên tục trong vòng lặp ngắn chỉ tốn giới hạn tốc độ và hiếm khi giúp ích.
• Ghi id kích hoạt vào log cho mỗi lần thất bại để nhận ra quy luật giữa các lượt chạy.

Người không phải lập trình viên có dùng tuyến +420 từ bảng điều khiển được không?

Được. Sau khi đăng ký bằng email và mã email 6 chữ số (hoặc đăng nhập Google), mở OTP Gateway, chọn dịch vụ và Cộng hòa Séc, kiểm tra giá hiển thị rồi đặt đơn. Số xác minh Cộng hòa Séc hiện ra ngay; dán vào ứng dụng, và mã sẽ xuất hiện trên cùng màn hình khi về tới. Hủy từ bảng điều khiển hoàn tiền về ví giống hệt lệnh gọi API.

Có số Séc dùng lâu dài không, và thanh toán thế nào?

Hiện không có số Séc dùng lâu dài tự phục vụ. Số chuyên dụng (Dedicated Numbers) là sản phẩm của Hoa Kỳ và Canada, từ $1.95/tháng, gồm SMS đến và đi cùng cuộc gọi trên trình duyệt; xem chi tiết tại số ảo. Nếu nhóm bạn cần một đường dây +420 lâu dài, hãy gửi email tới [email protected] để hỏi, và hiểu rằng khả năng đáp ứng phụ thuộc quy định địa phương và không được hứa trước.

Thanh toán là một ví USD trả trước, không phí hằng tháng và không phải chọn gói. Tiền được nạp bằng thẻ hoặc USDT/USDC, và mỗi lần nạp kích hoạt một hóa đơn PDF gửi qua email. Với công việc tích hợp, tài khoản phát triển có thể được chuyển sang sandbox theo yêu cầu để số và mã mô phỏng chạy qua toàn bộ luồng mà không tiêu tiền trong ví. Đăng nhập hai lớp bằng TOTP cũng có sẵn cho chính tài khoản.

Câu hỏi thường gặp

Tôi có thể kiểm thử luồng đăng ký Séc của ứng dụng mà không có SIM Séc không?

Được. Đặt một số +420 từ OTP Gateway cho dịch vụ bạn đang kiểm thử, nhập vào ứng dụng, rồi đọc mã từ bảng điều khiển, API hoặc webhook.

Mã quốc gia của Cộng hòa Séc trong API OTP Route là gì?

Dùng cz trong trường country của POST /api/v1/activations và trong các truy vấn giá.

Một mã xác minh Séc có giá bao nhiêu?

Mã bắt đầu từ $0.20 mỗi mã, và giá chính xác cho từng dịch vụ do GET /api/v1/prices trả về và hiển thị trước khi bạn đặt. Bạn chỉ trả tiền nếu mã về.

Số Séc có cần số 0 đứng đầu không?

Không. Số Séc không có tiền tố nội hạt, nên hãy lưu dưới dạng +420 theo sau là chín chữ số quốc gia.

Một kích hoạt +420 mở trong bao lâu?

Hai mươi phút. Nếu không có gì về trong thời gian đó thì kích hoạt hết hạn và ví được hoàn tiền đầy đủ.

Định tuyến OTP tới Cộng hòa Séc có phù hợp để tạo tài khoản hàng loạt không?

Không. OTP Route dùng để kiểm thử sản phẩm của chính bạn và vận hành các tài khoản hợp pháp của bạn. Hãy gắn mọi kích hoạt +420 với sản phẩm hoặc tài khoản của bạn, trong phạm vi điều khoản của từng dịch vụ và Chính sách Sử dụng Chấp nhận được của OTP Route.

Tôi có thể giữ cùng một số Séc cho những lần đăng nhập sau không?

Không theo dạng sản phẩm tự phục vụ. Số Dedicated lâu dài chỉ có ở Hoa Kỳ và Canada, và bạn có thể email cho bộ phận hỗ trợ để hỏi về các thị trường khác.

Tên dịch vụ là nhãn hiệu của chủ sở hữu tương ứng. OTP Route không liên kết với họ. Hãy sử dụng số hợp pháp, tuân thủ điều khoản của từng dịch vụ và Chính sách sử dụng chấp nhận được của chúng tôi.