Đưa mã SMS Ethiopia (+251) vào pipeline kiểm thử của bạn

Những lệnh gọi API nào lấy được mã xác minh Ethiopia?

OTP routing cho Ethiopia quy về năm lệnh HTTP đơn giản tới https://otproute.com/api/v1. Xác thực mỗi lệnh bằng một khóa Bearer bắt đầu bằng or_live_, tạo trong Developer console; một tài khoản giữ được tối đa 10 khóa, nên CI, staging và máy xách tay cục bộ có thể chạy bằng các thông tin xác thực riêng.

1. GET /api/v1/countries liệt kê mọi tuyến, và Ethiopia xuất hiện với id et.
2. GET /api/v1/services trả về các id dịch vụ, còn GET /api/v1/prices?country=et&service=<id> báo giá hiện tại và tình trạng sẵn có của cặp bạn định thử.
3. POST /api/v1/activations với {"service": "telegram", "country": "et"} giữ một số +251 và trả về id kích hoạt.
4. Nhập số đó vào ô điện thoại của sản phẩm đang kiểm thử và kích hoạt SMS của nó.
5. Đọc mã từ một sự kiện webhook hoặc bằng cách thăm dò GET /api/v1/activations/{id}, và dừng một lượt chạy gọn gàng bằng POST /api/v1/activations/{id}/cancel.

Kho số thay đổi trong ngày, nên hãy gọi endpoint giá lúc chạy thay vì gắn cứng bất cứ thứ gì. Một lệnh GET /api/v1/balance nhanh trước khi bộ kiểm thử bắt đầu giúp tác vụ dừng sớm khi ví sắp cạn. Cấu trúc yêu cầu và phản hồi của API xác minh SMS này có trong tài liệu dành cho lập trình viên.

Làm sao nối một webhook có chữ ký cho các lượt kích hoạt +251?

Thăm dò thì ổn cho một bài kiểm thử đơn lẻ, nhưng các tác vụ song song dễ kiểm soát hơn khi sự kiện được đẩy về cho bạn. Hãy đăng ký tối đa 5 endpoint webhook cho mỗi tài khoản và theo dõi activation.sms_received, activation.expired và activation.cancelled.

Mỗi yêu cầu mang X-OTPRoute-Signature: t=<unix>,v1=<hex>. Tính lại HMAC-SHA256 trên <t>.<raw body> bằng khóa bí mật của endpoint, so sánh kết quả với v1 bằng phép kiểm tra thời gian không đổi, và từ chối lệnh gọi khi dấu thời gian đã cũ. Hãy xác minh trên các byte thô trước khi bất kỳ trình phân tích JSON nào chạm vào chúng.

Hãy giả định một sự kiện có thể được giao nhiều hơn một lần: gắn trình xử lý với id kích hoạt và bỏ các bản lặp, để một sự kiện thử lại không bao giờ điền vào ô OTP hai lần. Nếu bạn ở lại với thăm dò, khoảng cách vài giây nằm thoải mái trong giới hạn 300 yêu cầu mỗi phút. Bài hướng dẫn của chúng tôi về bảo mật webhook OTP bằng HMAC có kèm một trình xử lý tham chiếu.

Hiện nay những dịch vụ nào có thể nhận mã SMS OTP Ethiopia?

Tuyến Ethiopia hiện liệt kê hơn 1,700 dịch vụ. Các mục phổ biến trong ảnh chụp trực tiếp gồm WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, ChatGPT (OpenAI), Microsoft & Outlook, LinkedIn, Uber, Signal, Viber, imo và Netflix.

Hãy coi danh sách đó là một ảnh chụp tại một thời điểm. Tình trạng của từng dịch vụ có thể đổi trong vài giờ, đó là lý do API báo cáo trực tiếp thay vì một bảng tĩnh. Hãy truy vấn endpoint quốc gia và giá ở đầu mỗi lượt chạy, và tìm trong toàn bộ danh mục ở dashboard nếu bạn cần dịch vụ ít phổ biến hơn.

Đội QA cần biết gì về định dạng số +251 và ngôn ngữ SMS?

Một số Ethiopia ở dạng E.164 là +251 theo sau bởi chín chữ số. Trong nước, người ta bấm thêm số 0 đứng trước chín chữ số đó, nên người dùng thường gõ 09… vào biểu mẫu của bạn. Hãy bỏ số 0 tiền tố nội hạt, thêm +251 phía trước và lưu chuỗi E.164 chuẩn, chỉ hiển thị kiểu địa phương trên giao diện. Hãy bao quát cả hai kiểu nhập, cùng với khoảng trắng và dấu gạch ngang, vì kiểm tra ô số điện thoại là nơi nhiều lỗi đăng ký ẩn náu.

Tiếng Amharic là ngôn ngữ làm việc của liên bang và được viết bằng chữ Ethiopic (Ge'ez), trong khi Afaan Oromo, Tigrinya và Somali được dùng rộng rãi ở các vùng của chúng. Phần lớn dịch vụ quốc tế gửi mã bằng tiếng Anh, nhưng một mẫu đã bản địa hóa có thể đến bằng tiếng Amharic. Hãy trích các chữ số bằng một mẫu thay vì khớp các từ xung quanh, và đảm bảo nhật ký của bạn lưu UTF-8 chính xác.

Các đội thường thử tuyến này khi ra mắt ứng dụng cho người dùng Ethiopia, kiểm tra bản địa hóa tiếng Amharic, hoặc phục vụ khách hàng ở nước ngoài đăng ký bằng số của quê nhà. Nếu sản phẩm hiển thị ngày tháng, lịch riêng của Ethiopia là một trường hợp bản địa hóa riêng đáng thêm vào. Trang kiểm thử QA cho thấy các đội khác tổ chức những bộ kiểm thử như vậy ra sao.

Người không phải lập trình viên có lấy được số xác minh Ethiopia từ dashboard không?

Có. Quản lý sản phẩm và nhân viên hỗ trợ có thể chạy cùng một luồng mà không cần viết code:

1. Tạo tài khoản bằng email và mã 6 chữ số, hoặc bằng đăng nhập Google, rồi bật xác thực hai yếu tố TOTP.
2. Nạp tiền vào ví.
3. Chọn Ethiopia, chọn dịch vụ, và đọc giá hiển thị trước khi xác nhận.
4. Dán số +251 vào ứng dụng bạn đang xác minh.
5. Giữ lượt kích hoạt mở; mã sẽ hiển thị tại đó khi được nhận.

Nhiều đội dùng cách này cho các lần kiểm tra nhanh một lần trong khi kỹ sư điều khiển cùng tuyến đó qua API.

Điều gì xảy ra khi mã +251 không bao giờ xuất hiện?

Mỗi lượt kích hoạt mở trong 20 phút. Bạn chỉ trả tiền nếu mã đến; nếu khung thời gian kết thúc mà không có SMS, hoặc bạn hủy, toàn bộ số tiền sẽ tự động quay về ví.

Khi không có gì đến:

• Hãy để khung thời gian chạy hết trước khi coi là thất bại, vì thời gian phụ thuộc vào dịch vụ và tuyến.
• Thử lại sau, hoặc đổi sang một tuyến dịch vụ khác nếu ca kiểm thử của bạn cho phép.
• Xác nhận dịch vụ có chấp nhận số ảo hay không. Một số từ chối, và cơ chế hoàn tiền tồn tại đúng cho tình huống đó.
• Đừng đặt lại liên tục trong vòng lặp ngắn. Hãy giãn cách các lần thử lại và ghi lại từng id kích hoạt để các quy luật lộ ra.

Bài viết về giảm số lần giao OTP thất bại liệt kê thêm các bước kiểm tra.

Có đường dây Ethiopia dài hạn không, và thanh toán được xử lý thế nào?

OTP Route không có số dài hạn tự phục vụ tại Ethiopia. Dedicated Number, những đường dây bạn giữ trong khi chúng được gia hạn, là sản phẩm chỉ có ở Mỹ và Canada, từ $1.95/month. Nếu nhóm bạn cần một đường +251 lâu dài, hãy gửi email đến [email protected] để hỏi; khả năng cung cấp phụ thuộc vào quy định địa phương và không được đảm bảo.

Các lượt kích hoạt Ethiopia trừ vào một ví USD trả trước duy nhất, không phí hằng tháng và không phải chọn gói. Nạp bằng thẻ hoặc stablecoin USDT/USDC; hóa đơn PDF sẽ gửi vào hộp thư của bạn sau mỗi lần nạp. Trước khi tiêu tiền thật cho một tích hợp mới, hãy yêu cầu chế độ sandbox cho tài khoản phát triển: nó trả về số và mã mô phỏng để toàn bộ luồng được chạy thử từ đầu đến cuối.

Số thử nghiệm Ethiopia từ OTP Route dùng để xác minh các sản phẩm và tài khoản mà tổ chức của bạn thực sự sở hữu; điều khoản của từng dịch vụ vẫn áp dụng, cũng như Chính sách Sử dụng Chấp nhận được của chúng tôi.

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

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

Có. Hãy đặt một số +251 cho dịch vụ của bạn từ OTP Gateway, nhập vào ứng dụng và đọc mã trong dashboard hoặc qua API. Bạn chỉ bị tính phí nếu mã đến.

Id quốc gia của Ethiopia trong API OTP Route là gì?

Là et. Hãy gửi et làm trường country khi tạo một lượt kích hoạt Ethiopia và khi truy vấn giá.

Một số +251 để thử nghiệm giá bao nhiêu?

Mã bắt đầu từ $0.20 mỗi mã. Số tiền chính xác cho từng dịch vụ được GET /api/v1/prices trả về và hiển thị trong dashboard trước khi bạn đặt.

Có nên lưu số điện thoại Ethiopia kèm số 0 đứng đầu không?

Không. Hãy giữ dạng E.164, +251 cộng chín chữ số, và bỏ số 0 trong nước mỗi khi người dùng gõ vào. Chỉ áp dụng định dạng địa phương trên màn hình.

Tin nhắn xác minh Ethiopia có đến bằng tiếng Amharic không?

Thường là tiếng Anh, dù một dịch vụ có thể dùng mẫu tiếng Amharic bằng chữ Ethiopic. Hãy phân tích các chữ số thay vì câu chữ để cả hai phiên bản đều chạy được.

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

Không qua tự phục vụ, vì một số dùng một lần chỉ phục vụ một mã. Với tài khoản cần đăng nhập lại, một Dedicated Number ở Mỹ hoặc Canada là lựa chọn phù hợp, hoặc bạn có thể gửi email cho bộ phận hỗ trợ để hỏi về Ethiopia.

Có cách nào thử API OTP Ethiopia mà không tốn tiền trong ví không?

Có. Hãy yêu cầu chế độ sandbox cho tài khoản phát triển và nó sẽ trả về số và mã mô phỏng, để bạn kiểm thử tích hợp từ đầu đến cuối.

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.