Đưa xác minh +993 của Turkmenistan vào quy trình OTP của bạn

Những lệnh gọi API nào trả về số xác minh Turkmenistan?

Hãy bắt đầu với các endpoint, vì chúng quyết định mọi thứ còn lại. Xác thực với https://otproute.com/api/v1 bằng khóa Bearer lấy từ Developer console; khóa có tiền tố or_live_ và mỗi tài khoản giữ được tối đa 10 khóa. Id quốc gia của Turkmenistan là tm.

1. GET /api/v1/services và GET /api/v1/countries cho bạn danh mục. Hãy lưu đệm nhưng làm mới hằng ngày.
2. GET /api/v1/prices?country=tm&service=<id> cho biết giá hiện tại và tuyến có mở cho dịch vụ đó hay không.
3. POST /api/v1/activations với {"service": "imo", "country": "tm"} giữ một số +993 và trả về id kích hoạt.
4. GET /api/v1/activations/{id} trả về trạng thái của đơn +993, cùng mã sau khi SMS đến.
5. POST /api/v1/activations/{id}/cancel giải phóng một đơn mà bài kiểm thử của bạn không cần nữa.
6. GET /api/v1/balance cho phép pipeline dừng sớm khi số dư sắp cạn.

Giới hạn của tài khoản là 300 yêu cầu mỗi phút, dùng chung cho mọi khóa. Tài liệu tham chiếu API mô tả cấu trúc yêu cầu và phản hồi.

Bài kiểm thử +993 nên lắng nghe webhook hay polling?

Polling phù hợp với một nhà phát triển đơn lẻ tự bấm qua luồng. Khi nhiều tác vụ chạy cùng lúc, webhook rẻ hơn và phản ứng nhanh hơn. Một tài khoản có thể giữ 5 endpoint webhook; hãy trỏ một endpoint vào trình chạy kiểm thử Turkmenistan của bạn cho activation.sms_received, activation.expired và activation.cancelled.

Hãy coi mọi lần gửi là không đáng tin cho đến khi được chứng minh ngược lại. Tách header X-OTPRoute-Signature thành t và v1, tính HMAC-SHA256 trên t, một dấu chấm và đúng nội dung thô với secret của endpoint, rồi so sánh trong thời gian không đổi. Từ chối các dấu thời gian nằm ngoài một dung sai ngắn để chặn tấn công phát lại. Lưu kết quả theo id kích hoạt để một lần gửi lại không làm thay đổi gì. Bài viết của chúng tôi về thu thập OTP bằng webhook giới thiệu một trình xử lý có hàng đợi, còn kiểm thử trong pipeline CI nói về thời gian chờ trong các job build.

Có thể xác minh những gì trên số xác minh Turkmenistan?

Tuyến tm liệt kê hơn 1.600 dịch vụ. Trong số những dịch vụ được yêu cầu nhiều nhất hiện nay có imo, Telegram, WhatsApp, Google (Gmail & YouTube), Instagram, Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI), Viber, WeChat, Discord và Snapchat. Các ứng dụng nhắn tin chiếm phần lớn lưu lượng thường ngày ở Trung Á, đó là lý do chúng xuất hiện nhiều như vậy.

Đây là một ảnh chụp, không phải cam kết. Năng lực từ các đối tác nhà mạng của chúng tôi thay đổi trong ngày, nên hãy truy vấn giá trước mỗi lần chạy thay vì cho rằng danh sách hôm qua vẫn đúng.

Số +993 được định dạng và bản địa hóa như thế nào?

Số quốc gia có nghĩa của Turkmenistan gồm tám chữ số, và hầu hết dải di động bắt đầu bằng 6. Trong nước, người ta bấm tiền tố trunk 8 phía trước; ở dạng quốc tế, tiền tố đó bị bỏ và số trở thành +993 theo sau là tám chữ số.

• Chuẩn hóa về E.164 (+9936XXXXXXX) ở rìa hệ thống của bạn và chỉ lưu dạng đó.
• Đừng dùng lại quy tắc kiểm tra viết cho các nước lân cận; độ dài và đầu số khác nhau giữa các nước Trung Á.
• Tiếng Turkmen là ngôn ngữ chính thức và được viết bằng bảng chữ cái Latin với các chữ như ä, ç, ň, ö, ş, ü, ý và ž. Tiếng Nga vẫn được hiểu rộng rãi. Vì vậy một SMS xác minh có thể đến bằng tiếng Turkmen, tiếng Nga hoặc tiếng Anh, và bộ trích xuất của bạn nên đọc các chữ số từ bất kỳ nội dung UTF-8 nào.

Các đội thường kiểm thử ở đây khi có kế hoạch triển khai tại Trung Á, khi giao diện tiếng Turkmen hoặc tiếng Nga cần QA bản địa hóa, hoặc khi họ phục vụ khách hàng đi lại giữa Ashgabat và các thị trường lân cận.

Có thể đặt mã +993 mà không cần viết mã không?

Có. Sau khi đăng ký bằng mã email hoặc Google và nạp tiền vào ví, hãy mở OTP Gateway, chọn một dịch vụ, chọn Turkmenistan và xác nhận mức giá hiển thị. Số +993 xuất hiện ngay; nhập nó vào nơi ứng dụng yêu cầu, yêu cầu gửi SMS, rồi theo dõi thẻ kích hoạt để thấy mã. Số này chỉ phục vụ đúng một lần xác minh đó.

Vì sao mã Turkmenistan có thể không đến?

• Dịch vụ từ chối số ảo. Một số dịch vụ có làm vậy. Đó là chính sách phía họ, và quy tắc hoàn tiền tồn tại chính xác cho trường hợp này.
• Tuyến đang bận. Thử lại sau hoặc với một lượt kích hoạt mới, sẽ dùng số khác.
• Cửa sổ bị cắt ngắn. Hãy để lượt kích hoạt mở đủ 20 phút; đơn hết hạn sẽ được hoàn tiền tự động.
• Vòng lặp thử lại quá dồn dập. Hãy giãn cách giữa các lần thử thay vì đặt đơn liên tiếp.

Những bước này giúp việc định tuyến OTP luôn ổn định cho mọi người dùng chung nhóm số.

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

Không có Dedicated Number tự phục vụ cho Turkmenistan. OTP Route chỉ bán đường dây dài hạn tại Hoa Kỳ và Canada, từ $1.95/tháng; yêu cầu cho các quốc gia khác có thể gửi tới [email protected], không có hứa hẹn rằng quy định địa phương cho phép.

Mọi thứ còn lại chạy từ một ví USD trả trước, không có phí hàng tháng. Thanh toán 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 để thử API xác minh SMS với số mô phỏng. Chỉ sử dụng cho các sản phẩm và tài khoản hợp pháp của chính bạn, trong phạm vi đ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.

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

Tôi có thể lấy số +993 để kiểm thử đăng ký trong ứng dụng của mình không?

Có. Hãy tạo một lượt kích hoạt với id quốc gia tm và dịch vụ bạn chọn, rồi dùng số trả về trong luồng đăng ký của chính bạn.

Một mã xác minh Turkmenistan có giá bao nhiêu trên OTP Route?

Từ $0.20 mỗi mã. Giá trực tiếp cho từng dịch vụ lấy từ endpoint giá và cũng hiển thị trong dashboard.

Tôi có cần thêm tiền tố 8 khi nhập số Turkmen không?

Không. Số 8 chỉ dùng để quay số trong nước, nên hãy dùng +993 và số quốc gia tám chữ số.

Làm sao biết một webhook về mã +993 thực sự đến từ OTP Route?

Hãy xác minh chữ ký HMAC-SHA256 trong header X-OTPRoute-Signature so với nội dung thô và từ chối các dấu thời gian cũ.

Có được hoàn tiền tự động khi không có SMS nào đến số Turkmenistan không?

Có. Khi cửa sổ 20 phút hết hạn hoặc bạn hủy, toàn bộ khoản phí được hoàn về ví của bạn.

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

Không qua hình thức tự phục vụ. Số dài hạn chỉ được cung cấp cho Hoa Kỳ và Canada; hãy gửi email cho bộ phận hỗ trợ nếu bạn có yêu cầu đặc biệt.

Tin nhắn OTP Turkmen sẽ đến bằng ngôn ngữ nào?

Tùy vào ứng dụng; tiếng Turkmen, tiếng Nga và tiếng Anh đều có thể, vì vậy hãy phân tích chữ số thay vì từ ngữ.

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.