Nối luồng xác minh SMS Ai Cập (+20) vào API OTP Route

Một tích hợp API OTP Ai Cập thực sự cần những yêu cầu nào?

Bảy endpoint bao phủ mọi thứ, tất cả nằm dưới https://otproute.com/api/v1 và đều xác thực bằng khóa Bearer có tiền tố or_live_. Hãy tạo một khóa cho mỗi môi trường trong Developer console; một tài khoản giữ được tối đa 10 khóa.

1. Tải danh mục bằng GET /api/v1/services và GET /api/v1/countries. Id quốc gia của Ai Cập là eg, ít khi đổi nên lưu bộ nhớ đệm được.
2. Trước mỗi đơn, hỏi GET /api/v1/prices?country=eg&service=<id> để biết giá và tình trạng khả dụng hiện tại. Lượng hàng thay đổi trong ngày, nên hãy coi phản hồi này là dữ liệu mới chứ không phải cấu hình.
3. Tạo kích hoạt bằng POST /api/v1/activations với phần thân như {"service": "whatsapp", "country": "eg"}. Bạn nhận về id kích hoạt và số +20 để nhập vào màn hình đang kiểm thử.
4. Lấy mã từ webhook hoặc bằng cách gọi GET /api/v1/activations/{id}.
5. Nếu bài test bị hủy, giải phóng đơn bằng POST /api/v1/activations/{id}/cancel để tiền quay về ngay.

Một lệnh GET /api/v1/balance nhanh ở đầu mỗi bộ test cho phép job CI dừng sớm thay vì hỏng giữa chừng. Giới hạn là 300 yêu cầu mỗi phút cho mỗi tài khoản, đủ chỗ để thăm dò nhiều kích hoạt song song. Các ví dụ yêu cầu đầy đủ nằm trong tài liệu dành cho lập trình viên.

Làm sao nhận mã +20 qua webhook có chữ ký thay vì thăm dò?

Thăm dò đủ dùng cho một bài test cục bộ; webhook phù hợp hơn khi một pipeline chạy nhiều kích hoạt Ai Cập cùng lúc. Thêm một endpoint trong Developer console (năm endpoint mỗi tài khoản) và đăng ký activation.sms_received, cùng activation.expired và activation.cancelled để job của bạn biết khi nào ngừng chờ.

Mỗi yêu cầu mang X-OTPRoute-Signature: t=<unix>,v1=<hex>. Dựng lại chuỗi <t>.<raw body>, tính HMAC-SHA256 bằng bí mật của endpoint, và so sánh với v1 bằng phép kiểm tra thời gian không đổi. Từ chối mọi yêu cầu có dấu thời gian cũ, và băm đúng các byte như nhận được thay vì một đối tượng đã phân tích rồi mã hóa lại.

Hãy coi id kích hoạt là khóa idempotency: lưu sự kiện một lần, bỏ qua các lần lặp, và trả về 2xx nhanh. Hướng dẫn thu mã OTP bằng webhook đi qua một phiên bản handler dùng hàng đợi.

Dịch vụ nào có thể gửi mã tới số xác minh Ai Cập?

Bản chụp trực tiếp cho Ai Cập liệt kê hơn 1.600 dịch vụ tổng cộng. Những dịch vụ phổ biến mà các đội kiểm thử trên số +20 gồm WhatsApp, Facebook, Instagram, TikTok, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, Uber, Snapchat, Viber, imo, ChatGPT (OpenAI), Amazon và LinkedIn.

Danh sách đó là cái nhìn tại một thời điểm, không phải lời hứa. Một dịch vụ có số sáng nay có thể khan hiếm vào chiều, đó chính là lý do endpoint giá báo tình trạng khả dụng cùng với chi phí. Một số dịch vụ cũng từ chối hoàn toàn số ảo; khi đó, quy tắc hoàn tiền nêu dưới đây bảo vệ bạn.

Ứng dụng nên lưu và kiểm tra số di động Ai Cập như thế nào?

Ai Cập dùng mã quốc gia +20 và tiền tố nội hạt 0. Ở trong nước, số di động được viết với mười một chữ số bắt đầu bằng 01, còn ở dạng quốc tế số 0 biến mất và mười chữ số theo sau +20. Vài thói quen tránh được hầu hết lỗi:

• Chỉ lưu E.164, như +201XXXXXXXXX, và định dạng để hiển thị ở lúc render.
• Bỏ số 0 nội hạt khi người dùng nhập 01… trong lúc quốc gia đã đặt là Ai Cập; nếu không bạn sẽ có một giá trị +2001… không hợp lệ.
• Chuẩn hóa chữ số. Người dùng bàn phím Ả Rập có thể gõ chữ số Ả Rập-Ấn Độ, nên hãy chuyển sang chữ số ASCII trước khi kiểm tra và trước khi so sánh OTP đã nhập.

Tiếng Ả Rập là ngôn ngữ chính thức, nên nhiều dịch vụ gửi mã cho người dùng Ai Cập bằng tiếng Ả Rập, trong khi số khác mặc định tiếng Anh. Nếu bộ phân tích của bạn rút mã bằng regex, hãy test cả với nội dung tin nhắn viết từ phải sang trái lẫn tiếng Anh.

Đội vận hành có đặt được số Ai Cập mà không cần viết code không?

Có. Không phải kiểm tra nào cũng cần script, và đồng nghiệp ở bộ phận hỗ trợ hay tăng trưởng có thể dùng cùng OTP Gateway từ trình duyệt:

1. Đăng ký bằng email và mã 6 chữ số, hoặc bằng Google.
2. Nạp ví và mở OTP Gateway.
3. Chọn Ai Cập và dịch vụ; giá hiện trước khi bạn xác nhận.
4. Sao chép số +20 vào ứng dụng và chờ mã xuất hiện trên màn hình.

Kích hoạt này giống hệt một đơn API, nên kiểm tra thủ công và kiểm tra tự động hành xử như nhau.

Nếu mã +20 không bao giờ xuất hiện thì sao?

Mỗi lượt kích hoạt mở trong 20 phút. Nếu không có SMS nào về trong khoảng đó, hoặc bạn hủy trước, toàn bộ số tiền quay về ví của bạn tự động, nên một số im lặng không bao giờ làm bạn mất tiền.

Khi mã liên tục thất bại:

• Hãy để cửa sổ chạy hết rồi mới quyết định thất bại; thời gian gửi phụ thuộc vào dịch vụ và tuyến.
• Xác nhận dịch vụ có chấp nhận số ảo hay không. Một số từ chối, và không lựa chọn định tuyến nào thay đổi được điều đó.
• Thử lại muộn hơn một chút, hoặc qua tuyến lân cận nếu bài test của bạn không phụ thuộc vào số Ai Cập.
• Tránh đặt lại liên tục trong vòng lặp ngắn. Để khoảng cách tăng dần giữa các đơn và giữ từng id kích hoạt trong log.

Các ghi chú của chúng tôi về giảm tỷ lệ gửi OTP thất bại đi sâu hơn vào chính sách thử lại.

Vì sao các đội sản phẩm kiểm thử với số Ai Cập?

Ai Cập là một trong những thị trường nói tiếng Ả Rập lớn nhất, nên là điểm dừng đầu tiên tự nhiên cho các đội bản địa hóa sản phẩm sang tiếng Ả Rập. Một số +20 thật kiểm tra những phần mà trình giả lập bỏ qua: bộ chọn quốc gia, xử lý số 0 nội hạt, mẫu SMS tiếng Ả Rập và bố cục phải sang trái trên màn hình nhập mã.

Các đội vận hành khu vực cũng dùng định tuyến OTP để xác nhận luồng đăng ký vẫn hoạt động với khách hàng Ai Cập sau mỗi bản phát hành, và các công ty phục vụ người Ai Cập sống ở nước ngoài kiểm tra xem số +20 có được chấp nhận ngoài lãnh thổ hay không.

Có đường dây Ai Cập dài hạn không, và thanh toán hoạt động ra sao?

Ai Cập không có số dùng lâu dài tự phục vụ. Đường dây chuyên dụng chỉ là sản phẩm của Hoa Kỳ và Canada, từ $1.95/tháng; nếu bạn cần một đường dây Ai Cập liên tục, hãy email [email protected] và đội ngũ có thể cho biết có khả thi theo quy định địa phương hay không, mà không 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 được theo sau bởi một hóa đơn PDF gửi qua email. Trong khi xây tích hợp, bạn có thể yêu cầu chế độ sandbox cho tài khoản phát triển, nơi trả về số và mã mô phỏng mà không đụng đến tiền trong ví. Mức giá hiện hành nằm trên trang giá.

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

Tôi có thể kiểm tra OTP đăng ký Ai Cập của ứng dụng mà không cần SIM Ai Cập không?

Được. Đặt một số +20 từ OTP Gateway, nhập vào biểu mẫu đăng ký, và đọc mã trong bảng điều khiển hoặc từ API, hoàn toàn không cần SIM địa phương.

API OTP Route dùng id quốc gia nào cho Ai Cập?

Ai Cập là eg. Truyền nó cho endpoint giá và trong phần thân của POST /api/v1/activations.

Tôi có phải trả tiền cho số +20 nếu SMS không bao giờ về không?

Không. Nếu không có mã nào về trong 20 phút, hoặc bạn hủy kích hoạt, toàn bộ số tiền được hoàn về ví của bạn tự động.

Tôi có nên giữ số 0 đứng đầu khi lưu số di động Ai Cập không?

Không. Số 0 là tiền tố nội hạt; hãy bỏ nó và lưu số theo dạng E.164 bắt đầu bằng +20.

Tháng sau tôi có đăng nhập lại bằng cùng số Ai Cập này được không?

Không chắc chắn. Mỗi số OTP Gateway chỉ phục vụ một mã xác minh, và số chuyên dụng tự phục vụ chỉ có cho Hoa Kỳ và Canada, nên hãy lập kế hoạch cho các tài khoản cần đăng nhập lặp lại dựa trên điều đó.

Tôi có thể dùng số Ai Cập để mở hàng loạt tài khoản trên một nền tảng không?

Không. OTP Route dùng để kiểm thử và vận hành sản phẩm cùng tài khoản hợp pháp của chính bạn; hãy tuân theo điều khoản của từng dịch vụ và Chính sách Sử dụng Chấp nhận đượ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.