Dùng một lần hay dài hạn? Chọn tuyến +1 787 cho các bài kiểm thử xác minh

Dự án Puerto Rico nên dùng OTP Gateway hay Số chuyên dụng?

Hãy bắt đầu từ việc số cần tồn tại bao lâu. OTP Gateway cấp một số +1 787 cho đúng một mã, phù hợp với bài kiểm thử đăng ký, kiểm tra bản địa hóa hoặc một job CI chỉ xác minh một lần rồi đi tiếp. Số chuyên dụng (Dedicated Number) là đường dây bạn giữ lại, phù hợp với tài khoản staging phải đăng nhập lại vào tuần sau hoặc hộp thư hỗ trợ dùng chung.

Với Puerto Rico, lựa chọn gần như đã được định sẵn. Dù hòn đảo là lãnh thổ của Hoa Kỳ, các số của nó không nằm trong kho Số chuyên dụng tự phục vụ; sản phẩm đó chỉ bao gồm Hoa Kỳ và Canada, từ $1.95/tháng. Nếu một đường dây ở lục địa Hoa Kỳ là chấp nhận được cho một tài khoản lặp lại, trang số ảo giải thích các lựa chọn. Nếu bạn thật sự cần đường dây dài hạn của Puerto Rico, hãy gửi email tới [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.

Những lệnh gọi API OTP Puerto Rico nào tạo và đọc một lượt kích hoạt?

API nằm ở https://otproute.com/api/v1 và yêu cầu khóa Bearer có tiền tố or_live_. Country id của Puerto Rico là pr.

1. Lấy các id bằng GET /api/v1/services và GET /api/v1/countries, rồi lưu đệm theo từng lần triển khai.
2. Tra giá cho yêu cầu: GET /api/v1/prices?country=pr&service=<id> trả về mức giá hiện tại và cho biết tuyến có đang mở không.
3. Đặt số bằng POST /api/v1/activations, nội dung {"service": "<id>", "country": "pr"}.
4. Đưa số được trả về vào luồng đang kiểm thử.
5. Nhận mã qua activation.sms_received trên webhook của bạn, hoặc polling GET /api/v1/activations/{id}.
6. Hủy bằng POST /api/v1/activations/{id}/cancel nếu job dừng sớm.

Các lệnh gọi webhook mang theo X-OTPRoute-Signature: t=<unix>,v1=<hex>. Hãy tính lại HMAC-SHA256 của <t>.<raw body> bằng secret của endpoint, so sánh trong thời gian không đổi, từ chối dấu thời gian cũ và bỏ qua các sự kiện lặp cho một activation id đã xử lý. Mỗi tài khoản có 10 khóa, 5 endpoint webhook và 300 yêu cầu mỗi phút. Hướng dẫn tích hợp API OTP đi sâu hơn.

Điều gì khiến số +1 787 và +1 939 dễ gây rắc rối trong biểu mẫu?

Puerto Rico thuộc Kế hoạch đánh số Bắc Mỹ (NANP), nên số của nó trông giống mọi số Hoa Kỳ: mã quốc gia 1, mã vùng ba chữ số (787 hoặc 939 chồng lấn) và bảy chữ số, được viết theo E.164 là +1787 hoặc +1939 cộng bảy chữ số.

Sự giống nhau đó gây ra lỗi thật. Một số ứng dụng liệt kê Puerto Rico là một quốc gia riêng với mã ISO PR, số khác gộp nó vào Hoa Kỳ, và biểu mẫu địa chỉ có thể mong đợi PR là giá trị của tiểu bang. Hãy xác nhận bộ chọn quốc gia, trình kiểm tra số điện thoại và các trường địa chỉ của bạn khớp nhau, và người dùng chọn Puerto Rico không bao giờ bị báo rằng số +1 của họ không hợp lệ. Hãy lưu số theo E.164 và suy ra khu vực từ mã vùng thay vì từ tiền tố +1 ở đầu.

Những dịch vụ nào có thể nhận mã SMS OTP của Puerto Rico?

Tuyến Puerto Rico hiện có hơn 900 dịch vụ. Các bên gửi phổ biến gồm WhatsApp, Uber, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), Amazon, ChatGPT (OpenAI), Microsoft & Outlook, LinkedIn, Discord, Airbnb, Netflix và Telegram. Tình trạng khả dụng thay đổi trong ngày, vì vậy hãy tin câu trả lời của API tại thời điểm đặt số hơn bất kỳ danh sách nào.

Nếu không dùng code, hãy mở OTP Gateway trong bảng điều khiển, chọn Puerto Rico và một dịch vụ, xác nhận giá hiển thị rồi đặt số. Số xác minh Puerto Rico xuất hiện cùng đồng hồ đếm ngược, và mã được in bên cạnh khi SMS đến.

Nếu mã không hiện trong 20 phút thì sao?

Mỗi lượt kích hoạt kéo dài 20 phút, và bạn chỉ trả tiền khi có mã đến. Nếu khung thời gian hết mà không có gì, hoặc bạn hủy, toàn bộ số tiền được tự động hoàn về ví.

Nếu mã Puerto Rico không về:

• Hãy cho lượt kích hoạt trọn khung thời gian trước khi đánh dấu bài kiểm thử là lỗi.
• Thử lại sau một chút, hoặc chọn một tuyến dịch vụ khác.
• Xác nhận dịch vụ chấp nhận số ảo; một số dịch vụ từ chối chúng, và khoản hoàn tiền có đó để bù đắp việc này.
• Đừng bắn các đơn đặt mới liên tục trong vòng lặp dày; hãy thêm cơ chế backoff lũy thừa giữa các lần thử.

Để biết thêm các mẫu xử lý, hãy đọc giảm thiểu việc gửi OTP thất bại.

Vì sao các nhóm xác minh cả luồng tiếng Tây Ban Nha lẫn tiếng Anh cho Puerto Rico?

Tiếng Tây Ban Nha và tiếng Anh đều là ngôn ngữ chính thức, và tiếng Tây Ban Nha là thứ tiếng phần lớn cư dân dùng hằng ngày. Điều đó khiến Puerto Rico trở thành nơi thực tế để kiểm tra onboarding song ngữ: tin SMS xác minh có đến bằng tiếng Tây Ban Nha khi ứng dụng đặt ở tiếng Tây Ban Nha không, màn hình nhập mã có xử lý được nội dung có dấu không, và mẫu tin đúng có được gửi đi khi người dùng đổi ngôn ngữ giữa chừng không? Hòn đảo dùng đô la Mỹ và nhiều công ty Mỹ đã phục vụ ở đó, nên các ứng dụng thanh toán, nền tảng giao hàng, sàn thương mại và ngân hàng mở rộng đợt ra mắt tại Mỹ thường cần một số +1 787 để kiểm thử. Hãy chạy các kiểm tra này trên tài khoản do bạn kiểm soát, tuân thủ điều khoản của từng dịch vụ và nằm trong Chính sách sử dụng chấp nhận được của OTP Route. Để tự động hóa chúng, xem kiểm thử CI/CD.

Ví và sandbox hoạt động thế nào cho các bài kiểm thử Puerto Rico?

Không có gói thuê bao. Một ví USD trả trước tài trợ cho mọi đơn đặt, 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 qua email cho mỗi lần nạp tiền và mua số. Trước khi chạy thật, hãy yêu cầu chuyển tài khoản phát triển của bạn sang sandbox, nơi trả về số và mã mô phỏng để có thể diễn tập toàn bộ luồng định tuyến OTP mà không tốn tiền. Khi sẵn sàng, hãy tạo tài khoản bằng email cùng mã 6 chữ số hoặc đăng nhập Google, và bật xác thực hai yếu tố TOTP cho nhóm.

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

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

Có. Đặt một số +1 787 từ OTP Gateway, nhập vào ứng dụng của bạn rồi lấy mã trong bảng điều khiển hoặc qua API xác minh SMS và webhook.

Puerto Rico có được coi là Hoa Kỳ trong API không?

Không. Nó có country id riêng là pr, bạn dùng trong tra giá và yêu cầu kích hoạt thay cho id của Hoa Kỳ.

Tôi có thể mua Số chuyên dụng +1 787 không?

Không từ bảng điều khiển. Số chuyên dụng tự phục vụ chỉ bao gồm Hoa Kỳ và Canada; với đường dây Puerto Rico, hãy gửi email tới [email protected] để hỏi.

Tin SMS xác minh sẽ bằng tiếng Tây Ban Nha chứ?

Điều đó tùy bên gửi và thường tùy cài đặt ngôn ngữ của ứng dụng. Nếu sản phẩm của bạn hỗ trợ cả hai, hãy kiểm thử cả bản tiếng Tây Ban Nha lẫn tiếng Anh.

Tôi có thể gặp những mã vùng nào trên số Puerto Rico?

Puerto Rico dùng 787 và 939. Dù nhận mã vùng nào, hãy lưu nó theo E.164 để dữ liệu của bạn nhất quán.

Một mã xác minh Puerto Rico giá bao nhiêu?

Từ $0.20 mỗi mã. Giá chính xác cho từng dịch vụ lấy từ GET /api/v1/prices và bảng điều khiển, và sẽ không tính phí nếu mã không bao giờ đến.

Tôi chạy được bao nhiêu bài kiểm thử song song?

Tài khoản cho phép 300 yêu cầu mỗi phút và 10 khóa. Phần lớn hạn mức đó bị dùng cho polling, nên webhook chừa nhiều dư địa hơn cho các job song song.

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.