Xác minh SMS Tunisia (+216): danh sách kiểm tra cho lập trình viên

Danh sách kiểm tra trước khi chạy cần có gì trước khi đặt số +216?

Chạy qua danh sách này một lần và hầu hết các lần kiểm thử Tunisia sẽ suôn sẻ:

• Khóa API đã sẵn sàng. Tạo khóa Bearer trong Developer console; khóa live bắt đầu bằng or_live_.
• Ví đã được nạp. OTP Gateway trừ từ số dư USD trả trước của bạn; GET /api/v1/balance xác nhận điều đó từ một script.
• Webhook truy cập được. Đăng ký một endpoint HTTPS, lưu secret của nó, và xác nhận đồng hồ máy chủ của bạn chính xác để các kiểm tra timestamp đạt.
• Đã kiểm tra giá. Gọi GET /api/v1/prices?country=tn&service=<id> cho đúng dịch vụ bạn định kiểm thử.
• Đã kiểm thử trường điện thoại. Đảm bảo biểu mẫu của bạn chấp nhận số quốc gia Tunisia tám chữ số và một số quốc tế +216 được dán vào.
• Bộ phân tích có dung sai. Xác nhận việc trích xuất mã hoạt động với nội dung tiếng Ả Rập, Pháp và Anh (xem bên dưới).
• Đã xem lại điều khoản. Bạn đang kiểm thử sản phẩm của chính mình hoặc vận hành tài khoản hợp pháp của chính mình, theo quy định của dịch vụ và Chính sách Sử dụng Chấp nhận được của OTP Route.

Số điện thoại Tunisia được định dạng E.164 như thế nào?

Tunisia dùng kế hoạch đánh số đóng: mọi số thuê bao có tám chữ số và không có tiền tố trung kế, nên không có gì phải bỏ trước khi thêm mã quốc gia. Dạng E.164 đơn giản là +216 theo sau tám chữ số đó. Người địa phương thường viết số theo nhóm như xx xxx xxx, nên hãy bỏ dấu cách, dấu chấm và dấu gạch ngang khi chuẩn hóa. Tránh kiểm tra theo một danh sách cố định các chữ số đầu; kiểm tra độ dài cộng một thư viện điện thoại uy tín an toàn hơn một bảng dải số viết tay.

Tin xác minh Tunisia đến bằng những ngôn ngữ nào?

Tiếng Ả Rập là ngôn ngữ chính thức, tiếng Ả Rập Tunisia là thứ người ta nói hằng ngày, và tiếng Pháp phổ biến trong kinh doanh, hành chính và nhiều ứng dụng. Vì vậy một lần kiểm thử có thể thấy mã bằng tiếng Pháp, Anh hoặc Ả Rập tùy bên gửi và locale của thiết bị.

Tin nhắn tiếng Ả Rập được gửi dưới dạng SMS Unicode và có thể chứa các dấu hướng phải sang trái quanh các chữ số. Một regex bắt chuỗi đầu tiên gồm bốn đến tám chữ số ASCII, sau khi loại bỏ các dấu vô hình, vẫn dùng được với cả ba ngôn ngữ. Các nhóm thường thêm Tunisia vào ma trận cho các đợt ra mắt ở Bắc Phi nói tiếng Pháp cùng Morocco và Algeria, cho QA bản địa hóa với bố cục từ phải sang trái, hoặc vì họ phục vụ khách hàng Tunisia sống ở châu Âu; một số +216 để kiểm thử bao quát cả những trường hợp đó.

Từng bước: nhận OTP Tunisia qua API

Bản chụp trực tiếp liệt kê hơn 1,700 dịch vụ cho Tunisia, gồm Facebook, WhatsApp, Instagram, Telegram, TikTok, Google (Gmail & YouTube), Snapchat, Signal, LinkedIn, Discord, ChatGPT (OpenAI), Microsoft & Outlook, Amazon và Uber. Tình trạng khả dụng thay đổi trong ngày, nên hãy để logic định tuyến OTP của bạn đọc nó từ GET /api/v1/services và GET /api/v1/countries khi một lần chạy bắt đầu.

1. Gửi POST /api/v1/activations với {"service": "facebook", "country": "tn"} và lưu activation id.
2. Nhập số được trả về vào ứng dụng bạn đang kiểm thử và kích hoạt mã.
3. Xử lý activation.sms_received trên webhook của bạn: xác minh X-OTPRoute-Signature (HMAC-SHA256 của timestamp, một dấu chấm và nội dung thô), từ chối timestamp cũ, và bỏ qua các bản trùng cho một activation id bạn đã xử lý.
4. Nếu không có webhook, polling GET /api/v1/activations/{id}, giữ rất thấp hơn giới hạn 300 yêu cầu mỗi phút.
5. Gọi POST /api/v1/activations/{id}/cancel nếu bài kiểm thử bị hủy giữa chừng.

Tài liệu API liệt kê mọi trường, và hướng dẫn kiểm thử trong CI cho thấy cách đưa việc này vào một pipeline.

Từng bước từ dashboard

1. Tạo tài khoản bằng email của bạn và mã sáu chữ số, hoặc bằng đăng nhập Google, và bật xác thực hai yếu tố TOTP.
2. Nạp tiền bằng thẻ hoặc USDT/USDC.
3. Chọn Tunisia, rồi chọn dịch vụ, và kiểm tra giá hiển thị.
4. Đặt đơn, sao chép số +216, và yêu cầu mã trong ứng dụng đích.
5. Sao chép mã Tunisia từ dashboard ngay khi nó hiện ra và hoàn tất bước đăng ký bạn đang kiểm thử.

Xử lý sự cố: nếu mã +216 không bao giờ xuất hiện thì sao?

Mỗi activation chạy trong 20 phút, và bạn chỉ trả tiền khi mã về. Nếu khung hết hạn hoặc bạn hủy, toàn bộ số tiền trở về ví.

• Không có gì tới cả: để khung hết, rồi thử lại sau hoặc qua một tuyến dịch vụ khác nếu bài kiểm thử cho phép.
• Dịch vụ từ chối số: một số dịch vụ từ chối số ảo; khoản hoàn tiền bao gồm trường hợp này.
• Webhook im lặng nhưng dashboard hiện mã: nhiều khả năng kiểm tra chữ ký của bạn đang thất bại; hãy so với nội dung thô, không phải JSON đã tuần tự hóa lại, và kiểm tra độ lệch đồng hồ.
• Nhiều lần thất bại liên tiếp: thêm back-off; đặt lại liên tục trong vòng lặp dày hiếm khi giúp ích.

Số dùng lâu dài, thanh toán và sandbox cho Tunisia

Không có số Tunisia dùng lâu dài tự phục vụ. Dedicated Number là sản phẩm của Mỹ và Canada từ $1.95/tháng; nếu bạn cần một số +216 lâu dài, hãy gửi email tới [email protected], lưu ý rằng khả năng cung cấp phụ thuộc quy định địa phương.

Ví hoạt động theo kiểu trả theo mức dùng, không phí hàng tháng, và mỗi lần nạp nhận một hóa đơn PDF qua email. Tài khoản phát triển có thể yêu cầu chế độ sandbox, nơi số và mã mô phỏng cho phép bạn chứng minh tích hợp mà không tốn số dư.

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

Tôi có thể kiểm thử luồng đăng ký Tunisia mà không cần SIM Tunisia không?

Có. Dùng một số +216 từ OTP Gateway và lấy mã trong dashboard hoặc qua API xác minh SMS và webhook.

Số điện thoại Tunisia có tiền tố trung kế cần bỏ không?

Không. Số Tunisia có tám chữ số, không có tiền tố trung kế, nên dạng E.164 chỉ là +216 cộng các chữ số đó.

Mã quốc gia của API OTP Tunisia là gì?

Dùng tn trong truy vấn giá và trong nội dung yêu cầu POST /api/v1/activations.

Số xác minh Tunisia giá bao nhiêu?

Từ $0.20 mỗi mã; số tiền chính xác phụ thuộc vào dịch vụ và hiển thị trong dashboard cùng endpoint giá trước khi bạn đặt đơn. Xem bảng giá.

Bộ phân tích của tôi lỗi với tin OTP tiếng Ả Rập. Tôi nên đổi gì?

Loại bỏ các dấu hướng Unicode và khớp chuỗi chữ số thay vì các từ xung quanh, để cùng một quy tắc dùng được cho nội dung tiếng Ả Rập, Pháp và Anh.

Tôi có thể giữ số +216 cho các lần đăng nhập sau không?

Không qua tự phục vụ. Số Gateway chỉ bao phủ một mã, và các số dùng lâu dài có ngay chỉ tồn tại ở Mỹ và Canada.

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.