Chạy kiểm thử xác minh tại Thổ Nhĩ Kỳ trên số +90, từng bước một

Chuẩn bị trước: cần chuẩn bị gì trước khi yêu cầu số +90?

Một danh sách kiểm tra ngắn giúp tránh lãng phí lượt kích hoạt khi kế hoạch kiểm thử tại Thổ Nhĩ Kỳ chính thức chạy:

1. Tra id dịch vụ của ứng dụng qua GET /api/v1/services và xác nhận id quốc gia tr qua GET /api/v1/countries.
2. Gọi GET /api/v1/prices?country=tr&service=<id> để xem cặp này hiện có giá bao nhiêu và có khả dụng hay không.
3. Bảo đảm số dư ví đủ cho đợt chạy bằng GET /api/v1/balance.
4. Đăng ký một endpoint webhook (mỗi tài khoản có tối đa năm endpoint) và không đưa secret của nó vào kho mã nguồn.
5. Đặt thư viện kiểm tra số điện thoại về vùng TR và quyết định giao diện sẽ hiển thị lại số cho người kiểm thử như thế nào.
6. Nạp locale tiếng Thổ vào môi trường kiểm thử, vì các lỗi chuyển chữ hoa chữ thường thường lộ ra ở đây đầu tiên.

Vì sao số 0 ở đầu làm hỏng việc kiểm tra số điện thoại Thổ Nhĩ Kỳ?

Trong nước, người dân viết số di động kèm tiền tố trunk, ví dụ 0 5XX XXX XX XX. Ở dạng quốc tế, số 0 biến mất: dạng chuẩn là +90 theo sau là số quốc gia gồm mười chữ số, và số di động bắt đầu bằng 5 sau mã quốc gia.

Các biểu mẫu chấp nhận cả hai kiểu cần một bước chuẩn hóa. Hãy bỏ khoảng trắng và dấu câu, bỏ một số 0 đứng đầu khi vùng là TR, thêm +90 vào đầu, rồi lưu kết quả theo E.164 (+905…). Đừng bao giờ giữ số 0 trunk trong giá trị đã lưu, nếu không cùng một người kiểm thử sẽ trông như hai người dùng khác nhau trong cơ sở dữ liệu của bạn. Hãy hiển thị lại theo kiểu số trong nước nếu người dùng Thổ Nhĩ Kỳ của bạn quen như vậy.

SMS xác minh tiếng Thổ sẽ trông thế nào với bộ phân tích của bạn?

Tiếng Thổ là ngôn ngữ chính thức, và các đầu số trong nước viết mã bằng tiếng Thổ với những chữ như ç, ş, ğ, ı, ö và ü. Các ứng dụng quốc tế thường theo ngôn ngữ của thiết bị hoặc tài khoản. Dù thế nào, hãy lấy mã bằng mẫu chữ số thay vì so khớp các từ xung quanh.

Locale tiếng Thổ cũng ẩn một cái bẫy phần mềm nổi tiếng: viết hoa chữ i thường cho ra İ có chấm, còn viết thường chữ I cho ra ı không chấm. Mã so sánh chuỗi bằng cách chuyển hoa/thường theo locale có thể làm hỏng bước đăng nhập hoặc kiểm tra email của người dùng Thổ Nhĩ Kỳ. Một đợt kiểm thử với số +90 là dịp tốt để phát hiện lỗi này, cùng với mặt nạ nhập liệu đúng độ dài và thông báo lỗi đã dịch. Hướng dẫn xác minh ứng dụng di động đề cập thêm các kiểm tra liên quan.

Những ứng dụng nào có thể định tuyến mã tới số xác minh Thổ Nhĩ Kỳ?

Ảnh chụp hiện tại cho tr gồm WhatsApp, Telegram, Instagram, TikTok, X (Twitter), Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, Uber, Netflix, AliExpress, Discord, ChatGPT (OpenAI) và Amazon. Tổng cộng, tuyến Thổ Nhĩ Kỳ hỗ trợ hơn 1.800 dịch vụ.

Các đội đặt số ở đây để ra mắt sản phẩm tại Thổ Nhĩ Kỳ, kiểm tra bản địa hóa trước một chiến dịch tiếp thị, hoặc phục vụ khách hàng nói tiếng Thổ đang sống ở nơi khác tại châu Âu. Vì năng lực thay đổi trong ngày, hãy dựa vào bảng giá trực tiếp thay vì một danh sách cố định trong cấu hình kiểm thử của bạn.

Làm sao yêu cầu và đọc OTP Thổ Nhĩ Kỳ qua API?

Chuỗi lệnh gọi rất ngắn. Gửi POST /api/v1/activations với {"service": "<id>", "country": "tr"} và một khóa Bearer có tiền tố or_live_. Đưa số +90 trả về vào ứng dụng đang kiểm thử. Khi SMS đến, OTP Route gửi activation.sms_received tới endpoint của bạn; nếu hết thời hạn trước đó, bạn nhận activation.expired, còn dừng thủ công sẽ tạo activation.cancelled.

Trước khi tin bất kỳ sự kiện nào, hãy tính lại chữ ký từ header X-OTPRoute-Signature: HMAC-SHA256 của dấu thời gian, một dấu chấm và nội dung thô của yêu cầu, dùng secret của endpoint làm khóa. Từ chối mọi yêu cầu có dấu thời gian cũ và coi các lần gửi lặp cho cùng một id kích hoạt là một sự kiện duy nhất. Polling GET /api/v1/activations/{id} là phương án dự phòng cho môi trường không nhận được HTTP đến. Bài viết về thu thập OTP bằng webhook và trung tâm nhà phát triển đi sâu hơn.

Thích bấm chuột hơn viết mã? Hãy dùng dashboard

Đồng nghiệp không chuyên kỹ thuật làm theo cùng logic ngay trên trình duyệt. Đăng nhập, nạp tiền, chọn dịch vụ và Thổ Nhĩ Kỳ, rồi sao chép số +90 vào ứng dụng. SMS đến sẽ hiện trên thẻ kích hoạt. Mỗi số tạm thời dùng được cho một mã trong khoảng thời gian 20 phút.

Nếu mã tiếng Thổ mãi không đến thì sao?

• Hãy chờ đủ 20 phút trước khi kết luận là thất bại.
• Xác nhận ứng dụng có chấp nhận số ảo hay không; một số ứng dụng từ chối, và cơ chế hoàn tiền tự động tồn tại cho trường hợp đó.
• Thử lại sau một lúc, hoặc dùng một tuyến dịch vụ khác nếu bài kiểm thử cho phép.
• Giãn cách các lần thử lại thay vì đặt liên tục trong vòng lặp nhanh.

Một lượt đặt kết thúc mà không có mã sẽ không tốn đồng nào, vì toàn bộ số tiền được hoàn về ví.

Thanh toán, sandbox và số dùng dài hạn

OTP Route chạy trên ví USD trả trước, không có gói nào để chọn. Hỗ trợ cả nạp tiền bằng thẻ và USDT/USDC, và mỗi lần nạp đều gửi hóa đơn PDF qua email. Nhà phát triển có thể yêu cầu chuyển tài khoản phát triển sang sandbox, nơi trả về số và mã mô phỏng cho các bài kiểm thử đầu-cuối mà không tốn tiền trong ví.

Không có số Thổ Nhĩ Kỳ dài hạn tự phục vụ. Các đội cần số như vậy có thể gửi email tới [email protected]; câu trả lời phụ thuộc vào quy định địa phương. Với những đường dây bạn giữ và gia hạn, Dedicated Numbers được cung cấp tại Hoa Kỳ và Canada từ $1.95/tháng.

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

Tôi có thể xác minh đăng ký ứng dụng tại Thổ Nhĩ Kỳ mà không cần SIM Thổ không?

Có. Một số +90 tạm thời từ OTP Gateway sẽ nhận mã, và bạn đọc mã đó trong dashboard hoặc qua API.

Có nên lưu số Thổ Nhĩ Kỳ kèm số 0 ở đầu không?

Không. Hãy lưu theo E.164 dưới dạng +90 cộng số quốc gia mười chữ số, và chỉ thêm số 0 trunk khi hiển thị theo định dạng trong nước.

Id quốc gia của Thổ Nhĩ Kỳ trong API là gì?

Là tr. Hãy truyền nó vào trường country của POST /api/v1/activations và trong truy vấn giá.

Một số +90 để kiểm thử có giá bao nhiêu?

Các lượt kích hoạt Thổ Nhĩ Kỳ bắt đầu từ $0.20 mỗi mã, và mỗi ứng dụng có mức giá riêng. Dashboard và GET /api/v1/prices hiển thị giá trước khi bạn đặt.

Điều gì xảy ra nếu mã không được gửi tới?

Nếu không có SMS nào đến trong 20 phút, hoặc bạn hủy lượt kích hoạt, toàn bộ khoản phí được hoàn về ví của bạn.

Có thể giữ một số Thổ Nhĩ Kỳ cho các lần đăng nhập sau không?

Không theo hình thức tự phục vụ. Hãy gửi email tới [email protected] để hỏi, và lưu ý rằng khả năng cung cấp phụ thuộc vào quy định địa phương.

Có quy tắc nào về cách sử dụng các số này không?

Có. Số Thổ Nhĩ Kỳ dành cho việc kiểm thử và vận hành các sản phẩm, tài khoản thuộc về bạn; điều khoản của từng ứng dụng vẫn được áp dụng, cũng như Chính sách Sử dụng Chấp nhận được của OTP Route.

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.