Nhận mã SMS Botswana chỉ bằng một lệnh gọi API

Một kích hoạt Botswana đi qua những lệnh gọi API nào?

Mọi thứ nằm dưới https://otproute.com/api/v1 và được xác thực bằng khóa Bearer bắt đầu bằng or_live_. Bạn tạo khóa trong Developer console; một tài khoản có thể giữ tối đa 10 khóa, và giới hạn là 300 yêu cầu mỗi phút, quá đủ cho một bộ kiểm thử đặt vài số Botswana mỗi lượt chạy.

Một trình tự điển hình trông như sau:

1. Gọi GET /api/v1/countries một lần và lưu đệm, để mã của bạn biết bw là định danh của Botswana.
2. Hỏi GET /api/v1/prices?country=bw&service=whatsapp để lấy giá trực tiếp và tình trạng còn hàng của cặp bạn cần. Giá thay đổi theo dịch vụ và quốc gia, vì vậy hãy đọc chúng thay vì viết cứng.
3. Gửi POST /api/v1/activations với nội dung {"service": "whatsapp", "country": "bw"}. Phản hồi chứa số +267 và một id kích hoạt.
4. Nhập số đó vào biểu mẫu đăng ký đang kiểm thử, rồi thăm dò GET /api/v1/activations/{id} hoặc chờ một webhook.
5. Nếu bài kiểm thử bị hủy, hãy gọi POST /api/v1/activations/{id}/cancel để tiền trở lại ví ngay.

Hướng dẫn tích hợp API OTP đi qua cùng các lệnh gọi này với trọng tâm là xử lý lỗi.

Trình nhận webhook của tôi nên xử lý sự kiện +267 thế nào?

Webhook là lựa chọn gọn hơn khi có nhiều hơn một bài kiểm thử chạy song song. Đăng ký một endpoint (năm cái mỗi tài khoản) và lắng nghe activation.sms_received, activation.expired và activation.cancelled, mỗi sự kiện được xác định theo id kích hoạt bạn nhận được khi đặt số.

Mỗi lần gửi mang header X-OTPRoute-Signature dạng t=<unix>,v1=<hex>. Hãy dựng lại HMAC-SHA256 của chuỗi "<t>.<raw body>" bằng secret của endpoint, so sánh với v1 bằng thời gian hằng định, và bỏ bất cứ thứ gì có dấu thời gian đã cũ. Chỉ phân tích JSON sau khi bước kiểm tra qua, vì việc tuần tự hóa lại nội dung làm thay đổi các byte.

Hãy làm cho trình xử lý có tính lũy đẳng: lưu id kích hoạt khi mã đã được dùng và bỏ qua lần lặp lại của cùng sự kiện. Chi tiết nằm trong bảo vệ webhook OTP bằng HMAC.

Số xác minh Botswana dùng được cho những gì?

Ảnh chụp trực tiếp của Botswana liệt kê hơn 800 dịch vụ. Trong số những dịch vụ phổ biến có WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, ChatGPT (OpenAI), Microsoft & Outlook, Amazon, LinkedIn, Uber, Signal, Netflix và Airbnb.

Tình trạng còn hàng trên một tuyến nhất định thay đổi trong ngày khi dung lượng nhà mạng thay đổi. Đó là lý do endpoint giá cũng báo cáo những gì có thể đặt ngay lúc này: hãy coi câu trả lời của nó là nguồn đáng tin thay vì danh sách này.

Kỹ sư nên biết gì về số điện thoại Botswana?

Botswana dùng mã quốc gia +267 và không có tiền tố trung kế, nên số quốc gia được quay đúng như được viết. Số di động có tám chữ số và bắt đầu bằng 7. Theo E.164, điều đó cho ra +267 theo sau là tám chữ số, không có số không nào để bỏ.

Một vài điểm thực tế cho bất kỳ ai lưu hoặc xác thực các số này:

• Chuẩn hóa mọi thứ về E.164 ngay khi nhập. Người dùng có thể gõ 00267, khoảng trắng hoặc dấu cộng ở đầu; hãy quy tất cả về một dạng chuẩn trước khi so sánh hoặc loại trùng.
• Đừng dùng lại quy tắc tiền tố trung kế từ một thị trường lân cận. Một trình xác thực sao chép từ quốc gia bỏ số không đứng đầu sẽ từ chối các mục nhập Botswana hợp lệ.
• Tiếng Anh và tiếng Setswana là các ngôn ngữ chính. Mã từ các ứng dụng toàn cầu thường đến bằng tiếng Anh, nhưng bộ phân tích của bạn nên trích xuất chữ số theo mẫu thay vì dựa vào lời văn cố định.

Các nhóm kiểm thử ở đây khi ra mắt sản phẩm tại miền nam châu Phi, kiểm tra onboarding cho khách hàng nằm bên kia biên giới với Nam Phi, hoặc chạy vận hành khu vực cần một số +267 địa phương để kiểm thử.

Người không phải lập trình viên có đặt được mã Botswana từ dashboard không?

Có. Đăng ký bằng email và mã sáu chữ số (hoặc Google), nạp ví, rồi mở OTP Gateway, chọn Botswana và dịch vụ, kiểm tra giá hiển thị và đặt. Dán số vào ứng dụng bạn đang kiểm thử; mã xuất hiện trong dashboard ngay khi SMS đến tuyến.

Mỗi kích hoạt mở trong 20 phút. Nếu không có tin nhắn nào đến trong thời gian đó, hoặc bạn hủy trước, toàn bộ số tiền tự động trở lại ví của bạn.

Nếu mã Botswana không bao giờ đến thì sao?

Tốc độ gửi phụ thuộc vào dịch vụ và tuyến, vì vậy hãy cho cửa sổ chút thời gian trước khi hành động. Nếu nó đóng mà trống, hãy đi qua danh sách này:

• Thử lại sau một lúc, hoặc chọn một tuyến dịch vụ khác cho cùng luồng nếu sản phẩm của bạn hỗ trợ.
• Xác nhận ứng dụng ở đầu bên kia sẵn sàng gửi tin nhắn tới đường dây ảo; một vài ứng dụng từ chối các số như vậy, và đó chính là lý do các kích hoạt không dùng được trả về số dư của bạn.
• Hãy để cửa sổ 20 phút kết thúc thay vì hủy sau một phút.
• Tránh đặt lại liên tục trong vòng lặp dày từ CI; thêm back-off giữa các lần thử.

Thêm các mẫu khác có trong giảm số lần gửi OTP thất bại. Dù bạn kiểm thử gì, hãy tuân thủ điều khoản của từng dịch vụ; Chính sách Sử dụng Chấp nhận được của OTP Route áp dụng cho mọi đơn.

Có đường dây +267 dùng lâu dài không, và thanh toán xử lý ra sao?

Không phải là một sản phẩm tự phục vụ. Số chuyên dụng chỉ được bán ngay tại Hoa Kỳ và Canada, từ $1.95/tháng; với Botswana, bạn có thể gửi email tới [email protected] để hỏi, và khả năng cung cấp còn tùy quy định địa phương. Xem số ảo để biết các đường dây Hoa Kỳ và Canada bao gồm những gì.

Thanh toán là một ví USD trả trước, không phí hằng tháng, nạp bằng thẻ hoặc USDT/USDC, và mỗi lần nạp đều kèm hóa đơn PDF qua email. Với công việc tích hợp, một tài khoản phát triển có thể được chuyển sang sandbox theo yêu cầu để toàn bộ luồng chạy trên số và mã mô phỏng. Mức giá hiện hành có trên trang bảng giá.

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

Id quốc gia của Botswana trong API OTP Route là gì?

Đó là bw. Hãy truyền nó làm country trong POST /api/v1/activations và trong chuỗi truy vấn của GET /api/v1/prices.

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

Có. Hãy đặt một số +267 cho dịch vụ của ứng dụng qua OTP Gateway và đọc mã trong dashboard hoặc trên webhook của bạn, không cần thẻ SIM hay điện thoại.

Số Botswana có cần số 0 ở đầu khi lưu không?

Không. Botswana không có tiền tố trung kế, vì vậy hãy lưu số dưới dạng +267 cộng với số di động tám chữ số.

Tôi có bị tính phí nếu mã +267 không đến không?

Không. Nếu không có gì đến trong cửa sổ 20 phút, hoặc bạn hủy, toàn bộ số tiền trở lại ví của bạn một cách tự động.

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

Không có số dùng lâu dài tự phục vụ cho Botswana. Đường dây dùng lâu dài là sản phẩm của Hoa Kỳ và Canada; hãy gửi email tới [email protected] nếu bạn cần hỏi về các lựa chọn khác.

Tôi có thể chạy kiểm thử Botswana trong CI mà không tốn tiền trong ví không?

Hãy yêu cầu chuyển tài khoản phát triển của bạn sang sandbox. Nó trả về số và mã mô phỏng, nên toàn bộ đường đi của API và webhook có thể được chạy thử mà không tốn chi phí.

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.