Mã xác minh +351 theo cách lập trình cho các đợt ra mắt tại Bồ Đào Nha

Một lượt xác minh +351 gọi những endpoint nào?

URL gốc là https://otproute.com/api/v1, và mọi yêu cầu đều mang khóa Bearer bắt đầu bằng or_live_. Mã quốc gia (country id) của Bồ Đào Nha là pt.

1. GET /api/v1/countries và GET /api/v1/services cho bạn các id; hãy lưu đệm chúng theo từng lượt chạy kiểm thử.
2. GET /api/v1/prices?country=pt&service=<id> trả về giá hiện tại và cho biết tuyến đang mở hay không.
3. POST /api/v1/activations với {"service": "telegram", "country": "pt"} giữ chỗ số và trả về một activation id.
4. GET /api/v1/activations/{id} báo trạng thái và mã, nếu bạn thích dùng polling.
5. POST /api/v1/activations/{id}/cancel giải phóng số mà bài kiểm thử của bạn không cần nữa.
6. GET /api/v1/balance giúp pipeline dừng sớm khi ví sắp hết tiền.

Giới hạn của tài khoản là 10 khóa API, 5 endpoint webhook và 300 yêu cầu mỗi phút. Đặc tả đầy đủ nằm trong tài liệu tham chiếu API.

Webhook có chữ ký chuyển mã Bồ Đào Nha đến dịch vụ của chúng ta như thế nào?

Đăng ký một endpoint HTTPS trong Developer console và đăng ký nhận activation.sms_received, activation.expired và activation.cancelled. Mỗi yêu cầu POST đều kèm X-OTPRoute-Signature: t=<unix>,v1=<hex>.

Để xác minh, hãy dựng lại chuỗi <t>.<raw body>, tính HMAC-SHA256 bằng secret của endpoint, rồi so sánh với v1 bằng phép so sánh thời gian không đổi. Từ chối các yêu cầu có dấu thời gian quá cũ để một yêu cầu bị bắt giữ không thể bị phát lại. Hãy lưu activation id của từng sự kiện và bỏ qua mọi lần lặp, nhờ đó trình xử lý vẫn an toàn khi việc gửi được thử lại. Mẫu này được giải thích từng bước trong bài về bắt OTP bằng webhook.

Những dịch vụ nào đang mở trên các tuyến Bồ Đào Nha?

Bồ Đào Nha hiện có hơn 2.000 dịch vụ trong bản chụp mới nhất. Các dịch vụ hay dùng gồm WhatsApp, Telegram, Airbnb, Uber, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LinkedIn, Microsoft & Outlook, Amazon, Netflix, Discord và Signal.

Danh sách này thay đổi trong ngày khi các đối tác nhà mạng của chúng tôi điều chỉnh dung lượng. Vì vậy, chính endpoint giá, chứ không phải một tệp cấu hình tĩnh, mới nên quyết định bài kiểm thử có chạy hay không.

Vì sao các nhóm sản phẩm kiểm thử với số Bồ Đào Nha?

Bồ Đào Nha thường xuất hiện sớm trong kế hoạch triển khai tại EU. Lisbon và Porto là nơi đặt nhiều nhóm sản phẩm và kỹ thuật, và không ít công ty dùng Bồ Đào Nha làm căn cứ châu Âu. Ngoài ra còn có lý do về bản địa hóa: tiếng Bồ Đào Nha châu Âu (pt-PT) khác tiếng Bồ Đào Nha của Brazil về chính tả, từ vựng và cách xưng hô, nên một luồng được dịch cho Brazil có thể nghe gượng gạo với người dùng ở Bồ Đào Nha. Chạy một lượt xác minh +351 thật cho phép người rà soát xem cùng lúc nội dung pt-PT, tin SMS nhận được và các màn hình xung quanh.

Theo GDPR, việc không đưa số điện thoại của nhân viên vào các tài khoản kiểm thử và tài khoản dùng chung cũng là cách tối thiểu hóa dữ liệu tốt. Mỗi lần kiểm tra dùng một số dùng một lần nghĩa là ít định danh cá nhân hơn trong hệ thống QA của bạn. Hướng dẫn pipeline CI chỉ cách đưa bước này vào mọi bản build.

Số +351 được định dạng và lưu trữ thế nào?

Bồ Đào Nha không có tiền tố trung kế: số có chín chữ số và được quay giống nhau ở trong nước lẫn dạng quốc tế sau +351. Số di động bắt đầu bằng 9, còn số cố định theo vùng bắt đầu bằng 2. Hãy lưu theo chuẩn E.164, từ chối mọi số không đủ chín chữ số sau mã quốc gia, và loại bỏ các khoảng trắng mà người dùng thêm vào khi gõ theo nhóm ba chữ số.

Mã gửi đến thường bằng tiếng Bồ Đào Nha hoặc tiếng Anh, tùy bên gửi và ngôn ngữ đặt cho tài khoản. Bộ trích xuất mã của bạn nên tìm các chữ số, không nên tìm một cụm từ cố định.

Đồng nghiệp có làm được việc này mà không cần code không, và nếu không có SMS thì sao?

Trong bảng điều khiển, hãy mở OTP Gateway, chọn Bồ Đào Nha và một dịch vụ, kiểm tra giá trực tiếp rồi đặt số. Dán số vào ứng dụng của bạn và chờ mã trên trang kích hoạt.

Khung thời gian kéo dài 20 phút, và bạn chỉ trả tiền nếu mã đến; nếu không, toàn bộ số tiền được tự động hoàn về ví. Khi thiếu mã:

• Hãy để khung thời gian chạy hết thay vì hủy sau vài giây.
• Xác nhận dịch vụ chấp nhận số ảo trong luồng đó.
• Thử lại sau, hoặc kiểm thử cùng màn hình đó với một tuyến dịch vụ khác.
• Hãy giãn cách giữa các lần thử thay vì đặt lại liên tục trong một vòng lặp dày.

Có số chuyên dụng của Bồ Đào Nha không, và thanh toán hoạt động ra sao?

OTP Route không bán số chuyên dụng tự phục vụ tại Bồ Đào Nha. Số ảo chuyên dụng (Dedicated Virtual Number) chỉ có ở Hoa Kỳ và Canada, từ $1.95/tháng; nếu cần một đường dây +351 dùng lâu dài, hãy gửi email tới [email protected], lưu ý rằng khả năng cung cấp phụ thuộc vào quy định địa phương và không được đảm bảo. Xem sự khác nhau giữa số tạm thời và số chuyên dụng.

Thanh toán theo mức dùng, từ ví USD trả trước, không có phí hàng tháng hay gói cước, nạp bằng thẻ hoặc USDT/USDC, và mỗi lần nạp đều có hóa đơn PDF. Tài khoản phát triển có thể được chuyển sang sandbox theo yêu cầu để kiểm thử với số và mã mô phỏng. 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 được áp dụng.

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

Country id của Bồ Đào Nha trong API OTP Route là gì?

Là pt, dùng trong cả truy vấn giá lẫn nội dung yêu cầu kích hoạt.

Số điện thoại Bồ Đào Nha có dùng tiền tố trung kế như số 0 ở đầu không?

Không. Số Bồ Đào Nha có chín chữ số và không có tiền tố trung kế, nên dạng E.164 là +351 theo sau là chín chữ số đó.

Tôi có thể kiểm thử luồng onboarding pt-PT mà không cần SIM Bồ Đào Nha không?

Có. Một số +351 để kiểm thử từ OTP Gateway sẽ nhận mã, và bạn đọc mã trong bảng điều khiển hoặc qua API.

Một số xác minh Bồ Đào Nha giá bao nhiêu?

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

Tôi có phải trả tiền cho một lượt kích hoạt +351 không nhận được gì không?

Không. Các lượt kích hoạt hết hạn hoặc bị hủy được hoàn tiền đầy đủ vào ví của bạn.

Tôi có thể thuê một số Bồ Đào Nha để đăng nhập liên tục không?

Không theo hình thức tự phục vụ. Đường dây dài hạn là sản phẩm dành cho Hoa Kỳ và Canada; hãy gửi email cho bộ phận hỗ trợ nếu bạn cần đường dây +351.

Tôi nên dùng polling hay webhook cho mã Bồ Đào Nha?

Webhook mở rộng tốt hơn cho các tác vụ song song, còn polling GET /api/v1/activations/{id} phù hợp với các runner không thể nhận lưu lượng đến.

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.