API OTP Qatar: webhook, polling và số kiểm thử +974

Chuỗi lệnh gọi API OTP Qatar trông như thế nào?

Mọi thứ nằm dưới https://otproute.com/api/v1, xác thực bằng khóa Bearer bắt đầu bằng or_live_. Bạn có thể giữ tối đa 10 khóa, vì vậy hãy cấp khóa riêng cho CI, staging và script vận hành, để có thể thu hồi một khóa mà không động đến các khóa khác. Một lượt kích hoạt +974 hoàn chỉnh cần nhiều nhất bốn lệnh gọi:

1. GET /api/v1/prices?country=qa&service=<id> trả về giá trực tiếp và cho bạn biết tuyến hiện đang mở cho dịch vụ đó.
2. POST /api/v1/activations với {"service": "<id>", "country": "qa"} giữ chỗ một số Qatar và trả về một activation id.
3. GET /api/v1/activations/{id} là lệnh polling: nó cho biết đơn Qatar đang ở bước nào và kèm mã sau khi được gửi.
4. POST /api/v1/activations/{id}/cancel kết thúc đơn sớm và trả tiền về ví.

Hai lệnh hỗ trợ hoàn thiện bức tranh: GET /api/v1/services ánh xạ tên sang service id, và GET /api/v1/balance giúp pipeline dừng trước khi cạn tiền. Hãy giữ lưu lượng dưới 300 yêu cầu mỗi phút cho mỗi tài khoản. Tổng quan dành cho nhà phát triển tập hợp các trang tham chiếu.

Trình xử lý webhook nên đối xử với các sự kiện kích hoạt Qatar thế nào?

Polling dùng được, nhưng webhook cho phép trình chạy kiểm thử của bạn phản ứng ngay khi có sự việc. Đăng ký tối đa năm endpoint và đăng ký nhận activation.sms_received, activation.expired và activation.cancelled; sự kiện đầu mang mã, hai sự kiện còn lại báo cho runner ngừng chờ.

Mỗi yêu cầu có X-OTPRoute-Signature theo dạng t=<unix>,v1=<hex>. Dựng lại chuỗi được ký gồm dấu thời gian, một dấu chấm và nội dung thô của yêu cầu, tính HMAC-SHA256 bằng secret của endpoint, rồi so sánh trong thời gian không đổi. Từ chối mọi yêu cầu có dấu thời gian đã cũ. Vì việc thử lại có thể gửi cùng một sự kiện nhiều lần, hãy lưu activation id và bỏ qua các lần lặp. Để xem một bản triển khai tham chiếu, đọc bắt OTP bằng webhook.

Những dịch vụ nào có thể định tuyến mã đến số +974?

Qatar là một trong những tuyến rộng hơn, với hơn 1.600 dịch vụ trong bản chụp mới nhất. Các mục phổ biến gồm WhatsApp, Google (Gmail & YouTube), Microsoft & Outlook, Telegram, Instagram, Facebook, LinkedIn, Snapchat, TikTok, Uber, Airbnb, ChatGPT (OpenAI), Claude và Discord.

Kho số thay đổi trong ngày, vì vậy hãy xem bản chụp chỉ để định hướng và coi câu trả lời của API là sự thật. Một số dịch vụ từ chối số ảo; khi đó đơn đặt đơn giản là hết hạn và tiền được trả lại. Mỗi tên ở trên là nhãn hiệu của chủ sở hữu tương ứng, không hàm ý có liên kết nào.

Chuẩn hóa số Qatar trong dữ liệu kiểm thử

Số Qatar có tám chữ số sau +974 và không có tiền tố trung kế, nên khi chuyển một số nội địa sang dạng quốc tế thì không có gì phải bỏ. Hãy giữ dữ liệu kiểm thử ở dạng E.164 (+974 cộng tám chữ số), và làm sạch các dữ liệu người dùng gõ với 00974, khoảng trắng hoặc một số 0 thừa ở đầu do thói quen từ quốc gia khác.

Tiếng Ả Rập là ngôn ngữ chính thức, trong khi tiếng Anh được dùng rộng rãi trong kinh doanh và bởi một dân số có tỷ lệ người nước ngoài lớn. Vì vậy các tin xác minh đến bằng ngôn ngữ nào mà dịch vụ gửi chọn cho tài khoản, thường là tiếng Anh hoặc tiếng Ả Rập. Hãy kiểm tra logic trích xuất của bạn tìm thấy mã ở cả hai hệ chữ viết và giao diện tiếng Ả Rập vẫn giữ ô nhập OTP dùng được trong bố cục từ phải sang trái.

Các nhóm kiểm thử tuyến Qatar khi ra mắt tại GCC, bản địa hóa ứng dụng tiêu dùng cho người nói tiếng Ả Rập, vận hành khách sạn hay logistics tại Doha, hoặc xác minh một tài khoản doanh nghiệp khu vực mà không đưa số cá nhân của nhân viên vào. Hướng dẫn kiểm thử CI chỉ cách đưa các kiểm tra này vào những lượt chạy tự động.

Thay vào đó, chạy kiểm tra Qatar từ bảng điều khiển

Không phải xác minh nào cũng cần script. Trong bảng điều khiển, hãy mở OTP Gateway, chọn Qatar và dịch vụ, xem giá hiển thị rồi xác nhận. Sao chép số +974 vào ứng dụng, yêu cầu gửi SMS, và mã sẽ xuất hiện trên đơn. Khung 20 phút được tính từ lúc bạn đặt đơn, và bạn chỉ trả tiền nếu mã đến.

Mã không đến: danh sách gỡ lỗi

• Đã chờ đủ lâu chưa? Hãy để lượt kích hoạt chạy hết khung thời gian trước khi coi là thất bại.
• Số ảo có được chấp nhận không? Một số dịch vụ chặn chúng, và thử đi thử lại sẽ không thay đổi điều đó.
• Chính sách thử lại có hợp lý không? Hãy giãn cách và thử lại sau, hoặc chuyển sang tuyến khác cho cùng dịch vụ. Đặt lại liên tục trong vòng lặp dày chỉ lãng phí giới hạn tốc độ của bạn và hiếm khi hiệu quả.
• Trình xử lý có khỏe không? Nếu việc kiểm tra chữ ký thất bại hoặc endpoint trả về lỗi, hãy polling GET /api/v1/activations/{id} để xem mã có được gửi trong khi webhook của bạn bỏ lỡ không.

Một lượt kích hoạt kết thúc mà không có SMS, do hết hạn hoặc do hủy, sẽ được hoàn tiền đầy đủ.

Có đường dây dài hạn ở Qatar không, và mức dùng được tính phí thế nào?

Không có số dài hạn tự phục vụ cho Qatar. Số ảo chuyên dụng (Dedicated Virtual Number), tức đường dây riêng của bạn với SMS đến và đi, chuyển tiếp webhook và gọi điện từ trình duyệt, chỉ được cung cấp tại Hoa Kỳ và Canada, từ $1.95/tháng. Với nhu cầu riêng cho Qatar, hãy gửi email tới [email protected]; quy định địa phương quyết định điều gì khả thi.

Mức dùng cho Qatar trừ vào một ví USD trả trước, và không có khoản nào tính theo tháng. Nạp bằng thẻ hoặc USDT/USDC, nhận hóa đơn PDF cho mỗi lần nạp, và yêu cầu chế độ sandbox cho tài khoản phát triển nếu bạn muốn kiểm thử tích hợp bằng số và mã mô phỏng. Chỉ dùng số +974 cho sản phẩm của chính bạn và các tài khoản doanh nghiệp hợp pháp, tôn trọng điều khoản của từng dịch vụ và tuân theo Chính sách sử dụng chấp nhận được của OTP Route.

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

Làm sao nhận mã SMS OTP của Qatar trong một bài kiểm thử tự động?

Tạo một lượt kích hoạt với country qa, nhập số được trả về vào ứng dụng đang kiểm thử, rồi chờ webhook activation.sms_received. OTP Route cũng hỗ trợ polling lượt kích hoạt nếu trình chạy kiểm thử của bạn không nhận được yêu cầu đến.

Tôi có thể dùng số +974 để kiểm thử mà không cần SIM Qatar không?

Có. OTP Gateway cung cấp một số xác minh Qatar cho một mã, nên bạn có thể kiểm thử luồng đăng ký hoặc đăng nhập mà không cần SIM hay thiết bị địa phương nào.

Làm sao kiểm tra giá của Qatar trước khi đặt?

Gọi GET /api/v1/prices?country=qa&service=<id> hoặc xem trong bảng điều khiển. Mức giá bắt đầu từ $0.20 mỗi mã và thay đổi theo dịch vụ.

Tôi có bị tính phí cho các lượt kích hoạt Qatar thất bại không?

Không. Bạn chỉ bị tính phí khi có mã đến; các lượt kích hoạt hết hạn hoặc bị hủy được tự động hoàn tiền về ví.

Vì sao nên kiểm thử bằng số Qatar thay vì số của một nước láng giềng?

Hãy chọn quốc gia khớp với thị trường thật của tài khoản. Nếu sản phẩm của bạn ra mắt ở Qatar, một số +974 sẽ kiểm tra đúng cách xử lý mã quốc gia, ngôn ngữ và định tuyến OTP mà khách hàng của bạn sẽ thấy, như được giải thích trong định tuyến OTP theo quốc gia.

Tài khoản phát triển có chạy được mà không cần tiền trong ví không?

Có. Theo yêu cầu, tài khoản phát triển có thể được chuyển sang sandbox, nơi trả về số và mã mô phỏng để kiểm thử đầu cuối.

Tôi có thể giữ một số Qatar cho các lần đăng nhập lặp lại không?

Không theo hình thức tự phục vụ, vì các đường dây chuyên dụng chỉ giới hạn ở Hoa Kỳ và Canada. Hãy gửi email tới [email protected] nếu bạn muốn hỏi về đường dây Qatar dài hạn.

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.