Thu thập mã OTP Indonesia +62 bằng lập trình

Một tích hợp API OTP Indonesia gọi những endpoint nào?

Mọi thứ chạy trên https://otproute.com/api/v1 với khóa Bearer mang tiền tố or_live_. Tạo một khóa trong bảng điều khiển Developer; một tài khoản có thể giữ tối đa 10 khóa, giúp dễ tách một runner CI khỏi một máy staging.

1. Lấy GET /api/v1/services và GET /api/v1/countries rồi lưu đệm cả hai danh sách. Indonesia xuất hiện với id id.
2. Hỏi GET /api/v1/prices?country=id&service=<id> để biết giá hiện tại và tình trạng sẵn có của dịch vụ bạn sắp kiểm thử. Kho số thay đổi trong ngày, nên hãy truy vấn ở mỗi lượt chạy thay vì gán cứng.
3. Tạo đơn bằng POST /api/v1/activations với nội dung như {"service": "tokopedia", "country": "id"}. Bạn nhận lại id kích hoạt cùng một số +62.
4. Nhập hoặc chèn số đó vào ô điện thoại của ứng dụng hoặc tài khoản kiểm thử của bạn.
5. Đọc kết quả qua webhook, hoặc polling GET /api/v1/activations/{id}. Hủy gọn gàng bằng POST /api/v1/activations/{id}/cancel khi một bài kiểm thử thất bại trước bước SMS.

Một lệnh GET /api/v1/balance nhanh trước khi bộ kiểm thử bắt đầu cho phép lượt chạy thất bại sớm thay vì giữa chừng. Polling với khoảng cách hợp lý nằm gọn trong mức trần 300 yêu cầu mỗi phút. Lược đồ đầy đủ có trong tài liệu API.

Làm sao xử lý mã +62 bằng webhook có chữ ký?

Polling ổn với một nhà phát triển đơn lẻ; các công việc song song sẽ êm hơn với phân phối đẩy. Đăng ký tối đa 5 endpoint cho mỗi tài khoản và đăng ký nhận activation.sms_received, activation.expired và activation.cancelled.

Mỗi yêu cầu có header X-OTPRoute-Signature dạng t=<unix>,v1=<hex>. Dựng lại chuỗi đã ký là <t>.<raw body>, tính HMAC-SHA256 với secret của endpoint, và so sánh với v1 theo thời gian không đổi. Băm các byte thô trước khi phân tích JSON, và bỏ các yêu cầu có timestamp quá cũ để payload bị bắt giữ không thể bị phát lại.

Coi các sự kiện được định danh theo id kích hoạt và làm cho handler idempotent: một lần gửi lại chỉ nên thấy mã đã được lưu. Bài viết của chúng tôi về bảo mật webhook HMAC đi qua các bước kiểm tra.

Những dịch vụ nào có thể nhận SMS OTP Indonesia trên OTP Route?

Bản chụp trực tiếp cho Indonesia bao phủ hơn 3.000 dịch vụ. Các tuyến phổ biến gồm WhatsApp, Tokopedia, Shopee, Lazada, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LINE, Discord, Microsoft & Outlook và ChatGPT (OpenAI).

Với đồng nghiệp không bao giờ đụng tới API, dashboard làm cùng việc đó: đăng nhập, chọn dịch vụ, chọn Indonesia, kiểm tra giá hiển thị rồi đặt đơn. Số +62 hiện trên màn hình và mã được hiển thị bên cạnh khi SMS đến. Hủy từ cùng màn hình đó nếu bài kiểm thử bị hoãn.

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

Indonesia dùng tiền tố trung kế là 0, nên người ta viết số di động trong nước là 08 theo sau bởi các chữ số còn lại. Trong E.164, số 0 biến mất: một số viết địa phương là 0812... trở thành +62812.... Hãy lưu dạng E.164, chuẩn hóa mọi thứ người dùng gõ bằng cách loại bỏ dấu cách, dấu gạch ngang và số 0 đứng đầu, và để một thư viện số điện thoại được bảo trì đánh giá tính hợp lệ, vì số thuê bao Indonesia không phải tất cả đều chung một độ dài.

Các mẫu SMS gửi tới số Indonesia thường bằng tiếng Indonesia (Bahasa Indonesia), dù một số dịch vụ gửi tiếng Anh. Hãy trích mã bằng mẫu chữ số thay vì khớp các từ như "kode" hay "code", và bộ phân tích của bạn sẽ không quan tâm mẫu tin dùng ngôn ngữ nào.

Vì sao các đội sản phẩm kiểm thử luồng đăng ký ở Indonesia?

Indonesia là một trong những quốc gia đông dân nhất thế giới và việc dùng internet ở đây ưu tiên di động rất mạnh, nên xác minh số điện thoại nằm ở phía trước của nhiều luồng onboarding. Các đội mở rộng sang Đông Nam Á muốn thấy màn hình đăng ký và đăng nhập Indonesia của mình hoạt động đúng với một số +62 thật, kiểm tra nội dung tiếng Indonesia hiển thị không bị cắt, và xác nhận các quy tắc chống gian lận của họ không chặn người dùng địa phương hợp lệ.

Các đội vận hành khu vực và marketplace cũng dùng tuyến này để xác minh các tài khoản doanh nghiệp họ quản lý cho các gian hàng Indonesia. Trang kiểm thử QA nói về cách đưa việc này vào kế hoạch hồi quy.

Nếu mã Indonesia không bao giờ xuất hiện thì sao?

Thời gian gửi phụ thuộc vào dịch vụ và tuyến, nên hãy cho lượt kích hoạt đủ thời gian trước khi quyết định nó thất bại. Khi không có SMS nào đến:

• Để cửa sổ 20 phút chạy hết, hoặc hủy; dù cách nào, toàn bộ số tiền cũng tự động quay về ví của bạn.
• Đặt lại sau một lúc, hoặc thử một tuyến dịch vụ khác nếu bài kiểm thử của bạn cho phép.
• Xác nhận dịch vụ đích chấp nhận số ảo cho thao tác này. Một số thì không, đó chính là lý do quy tắc hoàn tiền tồn tại.
• Tránh đặt lại đơn trong vòng lặp dồn dập. Hãy back off giữa các lần thử để một job CI không đốt hết lượt thử lại trong vài giây.

Có thêm ý tưởng chẩn đoán trong giảm lỗi gửi OTP.

Có số +62 riêng không, và tính phí thế nào?

Không. Đường dây Indonesia dài hạn tự phục vụ không được cung cấp. Dedicated Numbers là sản phẩm của Hoa Kỳ và Canada, từ $1.95/tháng. Nếu đội của bạn thật sự cần một đường dây +62 lâu dài, hãy gửi email tới [email protected]; việc có sắp xếp được hay không phụ thuộc vào quy định địa phương và không được hứa trước.

Thanh toán cho OTP Gateway dùng một ví USD trả trước, không phí hàng tháng và không gói để chọn. Nạp ví bằng thẻ hoặc stablecoin USDT/USDC; mỗi lần nạp kích hoạt một hóa đơn PDF gửi qua email cho hồ sơ tài chính của bạn. Tài khoản phát triển có thể yêu cầu chế độ sandbox, trả về số và mã mô phỏng cho các bài kiểm thử tích hợp đầu-cuối mà không tốn tiền. Xem bảng giá hoặc tạo tài khoản.

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

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

Có. Đặt một số +62 từ OTP Gateway cho dịch vụ liên quan, nhập vào ứng dụng của bạn, và đọc mã trong dashboard hoặc qua API.

API OTP Route dùng id quốc gia nào cho Indonesia?

Indonesia là id, nên một truy vấn giá có dạng GET /api/v1/prices?country=id&service=<id>.

Tôi có phải trả tiền nếu SMS Indonesia không bao giờ đế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ộ khoản phí tự động quay về ví của bạn.

Tôi có nên giữ số 0 đứng đầu khi lưu số di động Indonesia không?

Chỉ giữ nó để hiển thị theo định dạng địa phương. Hãy lưu +62 theo sau bởi số quốc gia không có số 0, đó là dạng E.164.

Tin nhắn xác minh Indonesia có bằng tiếng Anh không?

Không phải lúc nào cũng vậy. Nhiều tin đến bằng tiếng Indonesia, nên hãy phân tích mã số thay vì dựa vào các từ xung quanh.

Số Indonesia có được phép dùng cho mọi mục đích không?

Chỉ cho việc sử dụng hợp pháp: kiểm thử và vận hành sản phẩm cùng tài khoản của chính bạn trong đ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 hàng.

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.