Tích hợp mã xác minh +7 của Kazakhstan vào bộ kiểm thử của bạn

Một lượt chạy OTP Kazakhstan chạm đến những endpoint nào?

Một chu trình đầy đủ gồm năm hoặc sáu yêu cầu tới https://otproute.com/api/v1, ký bằng khóa Bearer bắt đầu bằng or_live_. Mã quốc gia của Kazakhstan là kz, và một tài khoản có thể giữ tối đa 10 khóa, nên CI, staging và máy của từng lập trình viên đều có thể có khóa riêng.

• GET /api/v1/balance ở đầu job, để ví trống làm lượt chạy thất bại sớm.
• GET /api/v1/prices?country=kz&service=telegram để đọc giá và tình trạng khả dụng hiện tại của cặp đó.
• POST /api/v1/activations với {"service": "telegram", "country": "kz"}, trả về mã kích hoạt và một số +7.
• GET /api/v1/activations/{id} nếu bạn polling, hoặc không cần gì nếu dựa vào webhook.
• POST /api/v1/activations/{id}/cancel khi bài kiểm thử kết thúc trước khi cần mã.

Giới hạn là 300 yêu cầu mỗi phút cho mỗi tài khoản, đủ chỗ cho các job song song polling vài giây một lần. Hãy bắt đầu từ hướng dẫn tích hợp API nếu đây là lần xây dựng đầu tiên của bạn.

Làm sao nhận mã +7 bằng webhook thay vì polling?

Đăng ký một endpoint trong Developer console (năm endpoint cho mỗi tài khoản) và đăng ký nhận activation.sms_received, activation.expired và activation.cancelled. Mỗi yêu cầu POST mang X-OTPRoute-Signature: t=<unix>,v1=<hex>.

Hãy dựng lại chữ ký bằng HMAC-SHA256 trên <t>.<raw body> với secret của endpoint và so sánh trong thời gian hằng số. Dùng các byte thô như nhận được, vì JSON được tuần tự hóa lại sẽ cho giá trị băm khác, và từ chối timestamp nằm ngoài dung sai ngắn để chặn phát lại. Vì một lần gửi có thể được thử lại, hãy upsert theo mã kích hoạt để bản sao thứ hai không thay đổi gì. Hướng dẫn từng bước có trong bài thu thập OTP bằng webhook.

Những ứng dụng nào có thể gửi mã đến số Kazakhstan?

Tuyến kz liệt kê hơn 1,700 dịch vụ. Các dịch vụ phổ biến trong bản chụp mới nhất gồm Telegram, WhatsApp, Google (Gmail & YouTube), Instagram, TikTok, Facebook, Viber, Discord, Microsoft & Outlook, LinkedIn, Uber, AliExpress và Amazon.

Đừng cố định danh sách đó vào code. Các tuyến thay đổi trong ngày, nên script cần kiểm tra GET /api/v1/prices trước mỗi đơn và chọn mã dịch vụ dự phòng khi một cặp không khả dụng.

Vì sao +7 cần được chăm sóc đặc biệt trong cơ sở dữ liệu số điện thoại?

Kazakhstan dùng chung mã quốc gia 7 với Nga. Cả hai đều dùng số quốc gia mười chữ số, và dải di động của Kazakhstan thường bắt đầu bằng 7 sau mã quốc gia, nên số như +7 7xx xxx xx xx là của Kazakhstan trong khi nhiều số di động Nga bắt đầu bằng 9. Đừng bao giờ suy ra quốc gia chỉ từ mã quay số; hãy xác định nó từ dải số bằng thư viện điện thoại được bảo trì, hoặc giữ một trường quốc gia tường minh.

Khi gọi trong nước, người ta quay số 8 trung kế trước mười chữ số. Hãy bỏ nó khi nhập và lưu dạng E.164, +7 theo sau là số quốc gia. Tiếng Kazakh là ngôn ngữ nhà nước và tiếng Nga cũng được dùng chính thức rộng rãi, nên tin nhắn xác minh có thể đến bằng tiếng Nga, tiếng Kazakh hoặc tiếng Anh, thường ở chữ Cyrillic. Hãy đảm bảo bộ phân tích SMS và log của bạn xử lý UTF-8 và trích các chữ số thay vì câu chữ.

Các đội kiểm thử ở đây khi ra mắt tại Trung Á, kiểm tra bản địa hóa song ngữ, hoặc hỗ trợ nhân viên vận hành khu vực.

Có lộ trình bảng điều khiển cho các đội không viết code không?

Có. Sau khi đăng ký bằng mã gửi qua email hoặc Google, hãy nạp ví, chọn Kazakhstan và dịch vụ, xác nhận giá hiển thị rồi đặt đơn. Số +7 và sau đó là mã xuất hiện trên thẻ kích hoạt. Quản lý sản phẩm và người kiểm thử bản địa hóa dùng cách này để kiểm tra nhanh trong khi pipeline lo phần khối lượng lớn.

Có thể giữ một số Kazakhstan để đăng nhập lặp lại không?

Không có lựa chọn tự phục vụ cho việc đó. Số OTP Gateway chỉ phục vụ một mã, và Dedicated Number dùng lâu dài chỉ bán cho Hoa Kỳ và Canada, từ $1.95/tháng với SMS đến và đi cùng gọi điện trên trình duyệt. Nếu bạn cần đường dây Kazakhstan chạy lâu dài, hãy gửi email đến [email protected]; việc có thể sắp xếp được hay không phụ thuộc vào quy định địa phương và không được đảm bảo. Với các tài khoản staging phải đăng nhập lại, một đường dây Mỹ hoặc Canada thường là giải pháp thực tế khi dịch vụ chấp nhận.

Điều gì xảy ra khi mã không đến trong 20 phút?

Lượt kích hoạt hết hạn, webhook phát activation.expired, và toàn bộ số tiền trở về ví mà bạn không cần làm gì. Sau đó hãy chẩn đoán trước khi thử lại:

• Số có được gửi với +7, chứ không phải số 8 nội địa không?
• Dịch vụ có từ chối số ảo không? Một số có, đó là lý do OTP Route hoàn tiền các lượt kích hoạt không dùng được.
• Thử lại sau hoặc trên tuyến khác thay vì lặp ngay lập tức; một khoảng lùi ngắn giữ cho log dễ đọc.

Tốc độ gửi phụ thuộc vào dịch vụ và tuyến, vì vậy hãy tránh timeout quá chặt trong các bài kiểm thử.

Tài khoản được tính phí như thế nào?

Một ví USD trả trước, trả theo mức dùng, không thuê bao và không có bậc gói. Nạp bằng thẻ hoặc stablecoin USDT hay USDC; mỗi lần nạp và mua số đều tạo hóa đơn PDF gửi qua email. Tài khoản phát triển có thể được chuyển sang sandbox theo yêu cầu, trả về số và mã mô phỏng cho các bài kiểm thử đầu-cuối. Hãy dùng dịch vụ cho các sản phẩm hợp pháp của chính bạn, tôn trọng điều khoản của từng ứng dụng và Chính sách sử dụng chấp nhận được, và xem bảng giá để biết mức giá hiện tại.

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

Làm sao phân biệt số +7 của Kazakhstan với số của Nga?

Hãy nhìn vào dải số, không chỉ mã quốc gia. Số di động Kazakhstan thường bắt đầu bằng 7 sau +7; thư viện số điện thoại được bảo trì hoặc một trường quốc gia tường minh giúp tránh nhầm lẫn.

Mã quốc gia của Kazakhstan trong API OTP Route là gì?

Dùng kz trong nội dung kích hoạt và trong tham số country của endpoint giá.

Tôi có thể kiểm thử luồng đăng ký Kazakhstan của ứng dụng mà không cần SIM địa phương không?

Có. Đặt một số +7 của Kazakhstan từ OTP Gateway, nhập vào luồng của chính bạn và thu mã qua webhook, polling hoặc bảng điều khiển.

Tôi có bị tính phí nếu mã Telegram không bao giờ đến không?

Không. Nếu không có SMS trong khung 20 phút, hoặc sau khi hủy, số tiền được trả về ví của bạn tự động.

Tin nhắn xác minh của Kazakhstan có bằng tiếng Nga hay tiếng Kazakh không?

Cả hai đều có thể, và một số dịch vụ dùng tiếng Anh. Hãy phân tích mã số và đảm bảo hệ thống của bạn xử lý được văn bản Cyrillic.

Tuyến Kazakhstan có phí hằng tháng không?

Không. OTP Route tính theo mức dùng từ ví USD trả trước được nạp bằng thẻ, USDT hoặc USDC.

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.