Thu OTP Bahamas +1 242 bằng lệnh REST và webhook

Tích hợp API OTP Bahamas cần những yêu cầu nào?

Một tích hợp API OTP Bahamas là một chuỗi ngắn các lệnh gọi tới https://otproute.com/api/v1, được cấp quyền bằng khóa Bearer có tiền tố or_live_ mà bạn tạo trong Developer console. Country id của Bahamas là bs; các service id như whatsapp hay telegram lấy từ danh mục.

1. Tải danh mục bằng GET /api/v1/services và GET /api/v1/countries, rồi giữ các id trong cấu hình thay vì khớp theo tên hiển thị.
2. Trước mỗi đơn, gọi GET /api/v1/prices?country=bs&service=<id>. Phản hồi mang giá hiện tại và cho bạn biết tuyến có đang mở vào lúc này không, vì tình trạng sẵn có thay đổi trong ngày.
3. Tạo activation bằng POST /api/v1/activations với phần thân {"service": "<id>", "country": "bs"}. Bạn nhận được activation id và một số +1 242.
4. Đưa số đó vào bước đăng ký hoặc đăng nhập của sản phẩm đang kiểm thử.
5. Chờ mã qua webhook, hoặc polling GET /api/v1/activations/{id}. Bỏ một lượt chạy gọn gàng bằng POST /api/v1/activations/{id}/cancel.

Một tài khoản có thể giữ tối đa 10 khóa và gửi 300 yêu cầu mỗi phút, nên staging, CI và laptop của đồng nghiệp đều có thể có một khóa riêng mà bạn thu hồi độc lập. Các tham số và phản hồi của API xác minh SMS này được liệt kê trong tài liệu API.

Làm sao xác minh webhook có chữ ký cho mã +1 242?

Polling là đủ cho một lần kiểm tra thủ công; khi nhiều bộ kiểm thử chạy song song, cách đẩy dữ liệu gọn gàng hơn. Đăng ký tối đa 5 endpoint trong Developer console và theo dõi activation.sms_received, activation.expired và activation.cancelled.

Mỗi lần gửi mang X-OTPRoute-Signature: t=<unix>,v1=<hex>. Dựng lại chuỗi được ký là <t>.<raw body>, chạy HMAC-SHA256 trên đó với secret của endpoint, rồi so sánh kết quả với v1 bằng hàm so sánh thời gian hằng số. Hãy làm việc trên các byte đúng như khi chúng đến; tuần tự hóa lại JSON đã phân tích sẽ làm đổi khoảng trắng và các digest sẽ không còn khớp. Từ chối mọi timestamp cũ hơn vài phút để một yêu cầu bị chặn bắt không thể bị phát lại.

Hãy định khóa trình xử lý theo activation id và làm cho nó idempotent, vì một lần gửi lại không bao giờ được đánh dấu một bài kiểm thử là đạt hai lần. Bài về bảo mật webhook OTP bằng HMAC đề cập độ lệch đồng hồ và xoay vòng secret.

Tuyến Bahamas có những dịch vụ nào, và nhân viên có thể đặt thủ công không?

Tuyến Bahamas hiện liệt kê hơn 900 dịch vụ. Các lựa chọn phổ biến gồm WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Amazon, Discord, LinkedIn, Uber, Airbnb và Signal. Hãy coi danh sách đó là một ảnh chụp; phản hồi API tại thời điểm đặt đơn mới là thứ có giá trị.

Đồng nghiệp không bao giờ đụng đến khóa nào cũng đạt kết quả tương tự trong trình duyệt. Đăng nhập, mở OTP Gateway, chọn Bahamas và dịch vụ, đọc giá hiển thị rồi đặt đơn. Số xác minh Bahamas xuất hiện kèm đồng hồ đếm ngược, và mã hiện trên cùng màn hình đó khi nó đến.

Chuyện gì xảy ra trong khung 20 phút, và nếu không có gì đến thì sao?

Mỗi activation mở trong 20 phút. Nếu có SMS đến trong thời gian đó, bạn trả giá niêm yết; nếu khung thời gian đóng mà không có gì, hoặc bạn hủy trước, toàn bộ số tiền tự động quay về ví.

Khi mã Bahamas không xuất hiện:

• Hãy để khung thời gian chạy hết trước khi kết luận bài kiểm thử thất bại; một số bên gửi xếp hàng tin nhắn.
• Thử lại sau hoặc qua một tuyến dịch vụ khác, vì nguồn số và hành vi của bên gửi thay đổi trong ngày.
• Kiểm tra xem dịch vụ có chấp nhận số ảo hay không. Một số từ chối, và đó chính là lý do chính sách hoàn tiền tồn tại.
• Tránh đặt lại liên tục trong vòng lặp chặt. Hãy giãn cách giữa các lần thử để một bài kiểm thử chập chờn không ngốn hết hạn mức yêu cầu của bạn.

Thêm nhiều mẫu xử lý sự cố được tập hợp trong bài giảm lỗi gửi OTP.

Nên lưu và chuẩn hóa số +1 242 như thế nào?

Bahamas thuộc Kế hoạch Đánh số Bắc Mỹ, nên số của họ dùng chung mã quốc gia 1 với Hoa Kỳ và Canada. Một số đầy đủ gồm 1, mã vùng 242 và số thuê bao bảy chữ số; ở dạng E.164 nó trở thành +1242 theo sau là bảy chữ số, tổng cộng mười một chữ số. Người dân thường chỉ nêu bảy chữ số nội địa, trong khi người gọi ở nơi khác trong kế hoạch bấm số 1 trước 242.

Hai hệ quả đối với mã của bạn. Một bộ xác thực suy ra quốc gia chỉ từ +1 sẽ gắn người dùng Bahamas là người Mỹ, vì vậy hãy kiểm tra mã vùng hoặc dựa vào một thư viện đánh số hiểu các vùng lãnh thổ NANP. Và hãy lưu mọi số ở dạng E.164, chỉ định dạng khi hiển thị, để việc tra cứu và loại trùng luôn nhất quán. Tin nhắn xác minh trên các số Bahamas thường bằng tiếng Anh, ngôn ngữ chính thức, nên việc kiểm tra bản địa hóa tập trung vào định dạng số và nhãn quốc gia thay vì nội dung dịch.

Vì sao các đội sản phẩm kiểm thử đăng ký với Bahamas?

Du lịch, khách sạn và dịch vụ tài chính gánh một phần lớn nền kinh tế Bahamas, nên các nền tảng đặt chỗ, ứng dụng gọi xe và giao hàng, sản phẩm thanh toán và ngân hàng có khách hàng vùng Caribe đều cần một lối đi hoạt động cho người dùng +1 242. Một số +1 242 để kiểm thử cho phép kỹ sư QA xác nhận biểu mẫu chấp nhận số, bộ chọn quốc gia hiển thị Bahamas thay vì gộp nó vào Mỹ, và nội dung đồng ý nhận SMS hiển thị đúng. Định tuyến OTP tốt cũng có nghĩa là chọn đúng quốc gia cho từng ca kiểm thử thay vì mặc định dùng số của đất liền. Cẩm nang kiểm thử QA cho thấy cách gắn việc này vào các bộ kiểm thử tự động. Hãy giữ mọi kiểm tra trên các tài khoản do tổ chức của bạn sở hữu và tuân theo điều khoản của từng dịch vụ; Acceptable Use Policy của OTP Route áp dụng cho mọi đơn.

Có thể có số Bahamas dùng lâu dài không, và việc sử dụng được tính phí ra sao?

Không có số dài hạn tự phục vụ cho Bahamas. Dedicated Numbers là sản phẩm của Mỹ và Canada từ $1.95/tháng, kèm SMS đến và đi, gọi thoại trên trình duyệt và chuyển tiếp webhook. Nếu nhóm bạn cần một số Bahamas lâu dài, hãy gửi email tới [email protected]; liệu có khả thi hay không phụ thuộc quy định địa phương và không thể hứa trước.

Việc sử dụng được trừ từ một ví USD trả trước, không có phí hằng tháng và không phải chọn gói. Nạp bằng thẻ hoặc USDT/USDC, và một hóa đơn PDF được gửi vào hộp thư của bạn cho mỗi lần nạp. Với công việc tích hợp, hãy yêu cầu chuyển một tài khoản phát triển sang sandbox: nó trả về số và mã mô phỏng, để toàn bộ luồng có thể được chạy thử mà không tốn tiền trong ví. Trang giá cho thấy các khoản phí hiển thị như thế nào.

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

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

Có. Đặt một số +1 242 từ OTP Gateway cho dịch vụ bạn đang kiểm thử, nhập vào luồng của bạn, và đọc mã trong dashboard hoặc qua webhook. Bạn trả từ $0.20 mỗi mã, và chỉ khi SMS đến.

Country id của Bahamas trong API là gì?

Là bs. Truyền nó cho GET /api/v1/prices và trong phần thân của POST /api/v1/activations.

Thư viện số điện thoại của tôi có coi +1 242 là số Mỹ không?

Chỉ khi nó đoán quốc gia chỉ từ mã quốc gia. Hãy kiểm tra mã vùng, hoặc dùng thư viện có dữ liệu lãnh thổ NANP, để số Bahamas được gắn nhãn đúng.

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

Không. Khi không có gì đến trong 20 phút, hoặc bạn hủy, toàn bộ số tiền tự động quay về ví của bạn.

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

Không như một sản phẩm tự phục vụ. Dedicated Numbers dài hạn chỉ có ở Hoa Kỳ và Canada; với số Bahamas, hãy gửi email tới [email protected] và đội ngũ sẽ cho bạn biết quy định địa phương cho phép những gì.

Một bộ kiểm thử có thể gửi bao nhiêu yêu cầu?

Tối đa 300 yêu cầu mỗi phút cho mỗi tài khoản, chia trên tối đa 10 khóa API. Polling vài giây một lần, hoặc chuyển sang webhook, giúp bạn nằm thoải mái trong giới hạn đó.

Tôi có thể nạp ví bằng stablecoin không?

Có. Ví chấp nhận thẻ và USDT/USDC, và mỗi lần nạp đều kèm hóa đơn PDF qua email.

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.