Cách nhận mã SMS OTP Kosovo qua API hoặc bảng điều khiển

Vì sao một đội sản phẩm cần số +383?

Kosovo là thị trường nhỏ nhưng có dấu ấn lớn ở nước ngoài: cộng đồng kiều dân đông đảo sống ở Đức, Thụy Sĩ và các nơi khác ở Tây Âu, và nhiều người trong số họ giữ số Kosovo để liên lạc với gia đình và giao dịch ngân hàng. Các ứng dụng phục vụ nhóm đối tượng này, từ du lịch đến chuyển tiền, cần thấy người dùng +383 trải nghiệm gì khi đăng ký.

Bản địa hóa là động lực còn lại. Tiếng Albania và tiếng Serbia đều là ngôn ngữ chính thức, nên một luồng được dịch sang một trong hai ngôn ngữ xứng đáng được kiểm thử đầu-cuối thực sự thay vì chỉ rà soát ảnh chụp màn hình. Một số xác minh Kosovo từ OTP Gateway cho phép QA chạy bước kiểm tra đó từ bất kỳ văn phòng nào.

Các đội vận hành khu vực đặt tại Pristina hoặc phụ trách cả Tây Balkan có lý do thứ ba: hồ sơ doanh nghiệp đăng ký với liên hệ địa phương đôi khi yêu cầu mã mới, và chuyển việc đó qua một công cụ dùng chung, có thể kiểm toán thì tốt hơn việc chuyền tay điện thoại của một nhân viên.

Hiện tuyến Kosovo có những ứng dụng nào?

Bản chụp hôm nay cho thấy hơn 400 dịch vụ cho Kosovo. Các dịch vụ phổ biến hiện có gồm WhatsApp, Viber, Telegram, Facebook, Instagram, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Snapchat, Netflix, Airbnb, Uber và Flipkart.

Danh sách nhỏ hơn so với các thị trường châu Âu lớn và thay đổi thường xuyên hơn, nên hãy coi mọi danh sách viết sẵn chỉ là gợi ý. Câu trả lời đáng tin cậy là những gì GET /api/v1/countries và bảng điều khiển trả về vào lúc bạn đặt số.

Làm việc với API OTP Kosovo trong thực tế

Mã quốc gia là xk. Một tích hợp điển hình tra mã dịch vụ từ GET /api/v1/services, kiểm tra chi phí bằng GET /api/v1/prices?country=xk&service=<id>, rồi mở một lượt kích hoạt bằng POST /api/v1/activations với nội dung như {"service": "telegram", "country": "xk"}. Phản hồi chứa số và một mã kích hoạt mà bạn giữ lại để dùng sau.

Từ đó, mã đến với bạn dưới dạng webhook activation.sms_received, được ký trong header X-OTPRoute-Signature bằng HMAC-SHA256 trên "<t>.<raw body>". Hãy từ chối timestamp cũ, và định danh trình xử lý theo mã kích hoạt để một lần gửi lại chỉ được xử lý một lần. Polling GET /api/v1/activations/{id} cũng dùng được khi job CI không có URL công khai. Xem hướng dẫn tích hợp để có ví dụ đầy đủ.

Điều gì thay đổi khi Kosovo có mã +383, và nên lưu số thế nào?

Kosovo chỉ nhận được mã quốc gia riêng +383 vào cuối thập niên 2010. Trước đó, mạng di động của họ dùng các mã mượn, trong đó có mã của Monaco và Slovenia, và một số hồ sơ khách hàng cũ vẫn chứa số ở các định dạng đó. Nếu bạn nhập dữ liệu cũ, hãy đánh dấu các mục đó thay vì tự động viết lại.

Số nội địa bắt đầu bằng tiền tố trung kế 0; một số di động hiển thị ở địa phương là 044 123 456 sẽ là +383 44 123 456 theo E.164. Hãy lưu dạng quốc tế, bỏ số 0 khi nhập, và chỉ định dạng khi hiển thị. Văn bản tiếng Albania dùng các chữ cái như ë nằm ngoài bảng chữ cái GSM cơ bản, nên một tin nhắn đã bản địa hóa có thể được gửi dưới dạng UCS-2 với các phân đoạn ngắn hơn.

Điều gì nên xảy ra khi mã Kosovo đến muộn hoặc bị thiếu?

Hãy cho lượt kích hoạt đủ 20 phút. Khi khung đóng mà không có SMS, hoặc bạn hủy, khoản phí được hoàn về ví tự động và activation.expired hoặc activation.cancelled được phát. Những bước tiếp theo hợp lý:

• thử lại sau một khoảng nghỉ hoặc chọn một tuyến lân cận, như Albania, nếu bài kiểm thử của bạn cho phép;
• kiểm tra xem dịch vụ đích có chấp nhận số ảo hay không;
• thêm backoff cho các lần thử lại tự động thay vì đặt số trong vòng lặp.

Đường dây lâu dài, ví và sandbox cho các dự án Kosovo

OTP Route không có số dùng lâu dài tự phục vụ cho Kosovo. Dòng Dedicated Number của họ, từ $1.95/tháng, chỉ bao gồm hai quốc gia: Hoa Kỳ và Canada. Để có đường dây +383 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.

Chi tiêu được trừ từ một ví USD trả trước duy nhất, trả theo mức dùng, nạp bằng thẻ hoặc USDT/USDC, với hóa đơn PDF gửi qua email cho mỗi lần nạp. Lập trình viên có thể yêu cầu chế độ sandbox cho tài khoản phát triển để nhận số và mã mô phỏng trong lúc nối webhook. Chi tiết xem tại bảng giá.

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

Tôi có thể kiểm tra đăng ký bằng tiếng Albania của ứng dụng với một số Kosovo thật không?

Có. Hãy đặt một số +383 để kiểm thử trong OTP Gateway, bắt đầu đăng ký bằng tiếng Albania, và mã xuất hiện trong bảng điều khiển cũng như webhook của bạn.

Kosovo dùng mã nào trong API xác minh SMS?

Kosovo là xk trong mọi endpoint nhận quốc gia, bao gồm GET /api/v1/prices và POST /api/v1/activations.

Một số xác minh Kosovo có giá bao nhiêu?

Từ $0.20 mỗi mã; mức giá chính xác phụ thuộc vào dịch vụ và được hiển thị trước khi bạn đặt, hoặc do endpoint giá trả về.

Vì sao tôi thấy ít dịch vụ cho Kosovo hơn cho Đức?

Phạm vi phủ phụ thuộc vào những gì các đối tác nhà mạng của chúng tôi có thể định tuyến vào từng quốc gia, và các thị trường nhỏ hơn có danh sách ngắn hơn. Hãy kiểm tra danh sách trực tiếp trước khi lên kế hoạch cho lượt kiểm thử.

Tiền của tôi sẽ ra sao nếu OTP Kosovo không bao giờ đến?

Tiền trở về ví đầy đủ khi khung 20 phút kết thúc mà không có SMS, hoặc ngay lập tức nếu bạn hủy.

Các số cũ +377 hoặc +386 có còn thuộc về người dùng Kosovo không?

Một số hồ sơ cũ có thể chứa chúng, nhưng số mới dùng +383. Hãy coi các định dạng cũ là dữ liệu cần rà soát, không phải thứ để chuyển đổi một cách mù quáng.

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

Không theo hình thức tự phục vụ. Mỗi số gateway chỉ dùng cho một mã, và đường dây dùng lâu dài là sản phẩm của Mỹ/Canada; hãy gửi email đến [email protected] để hỏi về Kosovo.

Có quy tắc nào về cách tôi dùng số của OTP Route không?

Có. Chỉ dùng OTP Route cho sản phẩm và tài khoản doanh nghiệp hợp pháp của chính bạn, tuân thủ điều khoản của từng dịch vụ, và tôn trọng Chính sách sử dụng chấp nhận được. Đăng ký để bắt đầu.

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.