Nhận mã xác minh Ấn Độ (+91) qua API

Chuỗi lệnh gọi API OTP Ấn Độ trông như thế nào?

Toàn bộ luồng chỉ là một vài yêu cầu tới https://otproute.com/api/v1, xác thực bằng khóa Bearer bắt đầu bằng or_live_. Khóa được tạo trong bảng điều khiển Developer, tối đa 10 khóa cho mỗi tài khoản, nên mỗi môi trường có thể có khóa riêng.

1. Gọi GET /api/v1/countries một lần và lưu đệm. Id quốc gia của Ấn Độ là in.
2. Gọi GET /api/v1/prices?country=in&service=<id> cho dịch vụ đang kiểm thử. Nó trả về giá và tình trạng sẵn có trực tiếp, nên hãy đọc ở mỗi lượt chạy.
3. Đặt đơn bằng POST /api/v1/activations với nội dung JSON như {"service": "telegram", "country": "in"}. Phản hồi cho bạn id kích hoạt và một số +91.
4. Nhập số đó vào màn hình đăng ký hoặc đăng nhập của ứng dụng của bạn.
5. Lấy mã qua webhook hoặc bằng cách polling GET /api/v1/activations/{id}. Nếu bài kiểm thử dừng sớm, gọi POST /api/v1/activations/{id}/cancel.

Hãy kiểm tra GET /api/v1/balance ở đầu bộ kiểm thử để một lượt chạy thất bại nhanh. API cho phép 300 yêu cầu mỗi phút, dư dả để polling vài giây một lần. Chi tiết yêu cầu và phản hồi có trong tài liệu API.

Nên xây handler webhook cho mã +91 như thế nào?

Webhook có chữ ký mở rộng tốt hơn polling khi các công việc chạy song song. Đăng ký một endpoint trong bảng điều khiển Developer (tối đa 5 cho mỗi tài khoản) và lắng nghe activation.sms_received, activation.expired và activation.cancelled.

Mỗi lần gửi mang header X-OTPRoute-Signature có dạng t=<unix>,v1=<hex>. Để kiểm tra, tính HMAC-SHA256 trên chuỗi <t>.<raw body> với secret của endpoint đó và so sánh kết quả với v1 theo thời gian không đổi. Có hai chi tiết hay làm người ta vấp:

• Băm các byte thô của yêu cầu, không bao giờ băm một đối tượng JSON đã tuần tự hóa lại; thứ tự khóa và khoảng trắng làm thay đổi digest.
• Từ chối timestamp cũ hơn vài phút để một yêu cầu bị bắt giữ không thể bị phát lại.

Định danh các thao tác ghi theo id kích hoạt để một lần gửi trùng trở thành thao tác không làm gì, và xác nhận bằng 2xx trước khi làm việc chậm. Bài viết của chúng tôi về bảo mật webhook OTP bằng HMAC đi qua bước so sánh từng dòng.

Những dịch vụ nào có thể gửi mã tới số Ấn Độ?

Tuyến Ấn Độ hiện liệt kê hơn 2.300 dịch vụ. Các mục phổ biến trong bản chụp trực tiếp gồm WhatsApp, Telegram, Google (Gmail & YouTube), Instagram, Facebook, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Amazon, LinkedIn, Discord, Uber và Snapchat.

Tình trạng sẵn có thay đổi trong ngày, đó là lý do API báo cáo nó trực tiếp. Nếu ma trận kiểm thử của bạn phụ thuộc vào một dịch vụ, hãy truy vấn giá cho in trước lượt chạy và bỏ qua gọn gàng khi tuyến đó đóng. Chỉ dùng các tuyến này cho sản phẩm và tài khoản của chính bạn, tuân theo điều khoản của từng dịch vụ, và nhớ rằng Chính sách sử dụng chấp nhận được của OTP Route có hiệu lực.

Người không phải nhà phát triển có thể đặt số xác minh Ấn Độ từ dashboard không?

Có. Nhân viên vận hành và quản lý tài khoản agency có thể bỏ qua API:

1. Tạo tài khoản bằng email cùng mã email 6 chữ số, hoặc bằng đăng nhập Google, rồi bật xác thực hai lớp TOTP.
2. Nạp tiền vào ví.
3. Chọn Ấn Độ và dịch vụ, kiểm tra giá trên màn hình rồi đặt đơn.
4. Nhập số +91 vào ứng dụng bạn đang thiết lập; mã xuất hiện trên trang kích hoạt khi SMS đến.

Dashboard và API dùng chung một cửa sổ, một quy tắc hoàn tiền và một ví.

Tôi nên làm gì khi không có mã nào đến trong 20 phút?

Mỗi lượt kích hoạt giữ mở trong 20 phút. Bạn chỉ trả tiền nếu SMS đến: khi cửa sổ đóng mà trống, hoặc bạn hủy trước, toàn bộ số tiền tự động quay về ví và webhook của bạn nhận activation.expired hoặc activation.cancelled.

Nếu thiếu mã:

• Hãy để cửa sổ chạy hết trước khi phản ứng; một dịch vụ có thể chỉ chậm hơn bình thường khi gửi.
• Xác nhận dịch vụ có chấp nhận số ảo hay không. Một số nền tảng từ chối chúng, đó là chính sách của phía họ chứ không phải lỗi gửi.
• Thử lại sau, hoặc kiểm thử với một tuyến dịch vụ khác.
• Đừng bao giờ đặt lại đơn trong vòng lặp dồn dập. Hãy back off giữa các lần thử để bạn không tốn công sức cho một tuyến đang từ chối số.

Có phần trình bày dài hơn về chiến lược thử lại trong giảm lỗi gửi OTP.

Nên lưu và chuẩn hóa số điện thoại Ấn Độ như thế nào?

Số di động Ấn Độ dài mười chữ số và trên thực tế bắt đầu bằng 6, 7, 8 hoặc 9. Người trong nước Ấn Độ thường viết chúng với tiền tố trung kế 0 đứng đầu, hoặc tách năm và năm bằng dấu cách. Định dạng quốc tế bỏ 0 đó và thêm mã quốc gia, cho ra +91 theo sau bởi mười chữ số.

Chỉ lưu dạng E.164: +91 cộng mười chữ số, không có dấu cách, dấu gạch ngang hay số 0. Chuẩn hóa đầu vào ngay ở rìa hệ thống bằng cách loại bỏ định dạng, số 0 đứng đầu, hoặc 91 trần gõ không có dấu cộng. Điều đó ngăn việc có người dùng trùng lặp chỉ khác nhau về định dạng.

Phần lớn SMS xác minh ở Ấn Độ đến bằng tiếng Anh và từ tiêu đề người gửi chữ-số thay vì một số điện thoại. Một số ứng dụng gửi tiếng Hindi hoặc ngôn ngữ vùng khác, nên hãy kiểm thử bộ phân tích mã với cả chữ viết không phải Latin.

Vì sao các đội sản phẩm cần số +91 để kiểm thử?

Ấn Độ là thị trường ra mắt phổ biến cho ứng dụng tiêu dùng, onboarding fintech và marketplace, và người dùng ở đây mong đợi một bước SMS khi đăng ký. Các đội dùng tuyến +91 để diễn tập một đợt ra mắt, để chạy QA bản địa hóa trên các giao diện tiếng Hindi, Tamil, Telugu, Bengal, Marathi và ngôn ngữ khác, để hỗ trợ nhân viên vận hành khu vực, và để kiểm tra các luồng mà khách hàng kiều dân Ấn Độ ở nước ngoài dùng khi vẫn đăng nhập bằng số ở quê nhà. Định tuyến OTP tốt ở đây nghĩa là chọn tuyến dịch vụ khớp với hành trình người dùng thật, rồi nối nó vào cùng các lệnh gọi API xác minh SMS mà các thị trường khác của bạn dùng.

Có đường dây Ấn Độ dài hạn không, và thanh toán hoạt động thế nào?

Không. Số riêng là sản phẩm của Mỹ và Canada, từ $1.95/tháng, và bạn không thể mua đường dây Ấn Độ dài hạn từ dashboard. Nếu cần, hãy gửi email tới [email protected]; khả năng đáp ứng phụ thuộc vào quy định địa phương và không được đảm bảo.

Thanh toán chạy trên một ví USD trả trước duy nhất, không phí hàng tháng và không gói để chọn. Nạp bằng thẻ hoặc stablecoin USDT/USDC, và mỗi lần nạp đến kèm hóa đơn PDF qua email. Với công việc tích hợp, hãy nhờ bộ phận hỗ trợ chuyển tài khoản phát triển sang sandbox: nó trả về số và mã mô phỏng, để bạn kiểm thử handler webhook đầu-cuối mà không tốn tiền ví.

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

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

Có. Đặt một số +91 qua OTP Gateway, nhập vào màn hình đăng ký của bạn, và đọc mã từ dashboard, API hoặc webhook.

Id quốc gia của Ấn Độ trong API OTP Route là gì?

Là in. Truyền nó làm quốc gia trong GET /api/v1/prices và trong nội dung của POST /api/v1/activations.

Nhận SMS OTP Ấn Độ tốn bao nhiêu?

Mã bắt đầu từ $0.20 mỗi mã và giá chính xác phụ thuộc vào dịch vụ. Bạn thấy nó trước khi đặt, và lượt kích hoạt không nhận được mã sẽ được hoàn vào ví.

Tôi có thể dùng lại cùng số +91 để đăng nhập lần nữa vào tháng sau không?

Không. Một số gateway chỉ phục vụ một mã xác minh. Các tài khoản cần đăng nhập lặp lại thuộc về đường dây riêng, và loại đó chỉ có ở Mỹ và Canada.

Có sandbox để xây dựng tích hợp Ấn Độ không?

Có, theo yêu cầu. Bộ phận hỗ trợ có thể chuyển tài khoản phát triển sang sandbox, nơi số và mã mô phỏng đi qua code của bạn mà không đụng đến ví.

Đội tài chính của chúng tôi có thể thanh toán bằng stablecoin không?

Có. Ví nhận thanh toán thẻ cũng như USDT và USDC, và mỗi lần nạp tạo một 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.