Checklist trước khi chạy để nhận mã xác minh +372 tại Estonia

Checklist trước lần đặt số +372 đầu tiên gồm những gì?

Phần lớn các lượt kiểm thử thất bại đều bắt nguồn từ việc thiếu một thứ gì đó trước khi số được yêu cầu. Hãy đánh dấu các mục sau trước:

• Một khóa API tạo trong Developer console. Mỗi khóa mang tiền tố or_live_ và được gửi dưới dạng Bearer token; một tài khoản chứa được 10 khóa, nên trình chạy CI xứng đáng có một khóa riêng.
• Một endpoint webhook với khóa bí mật được lưu phía máy chủ, nếu bạn muốn được gọi thay vì phải thăm dò. Mỗi tài khoản được dùng năm endpoint.
• Đúng các id. Estonia là ee trong mọi yêu cầu, còn id dịch vụ lấy từ GET /api/v1/services.
• Kiểm tra giá trực tiếp. Gọi GET /api/v1/prices?country=ee&service=<id> để tác vụ biết chi phí trước khi dùng đến tiền trong ví.
• Sandbox, nếu bạn vẫn đang nối các thành phần. Theo yêu cầu, một tài khoản phát triển có thể chuyển sang chế độ sandbox, trả về số và mã mô phỏng từ đầu đến cuối mà không động đến số dư.
• Ngân sách tốc độ gọi. API chấp nhận 300 yêu cầu mỗi phút cho mỗi tài khoản, thừa sức trừ khi bộ kiểm thử thăm dò thiếu cẩn thận.

Hướng dẫn tích hợp API OTP đi sâu hơn vào từng mục này.

Tôi chạy một yêu cầu API OTP Estonia từ đầu đến cuối như thế nào?

Khi checklist đã xong, chuỗi lệnh gọi khá ngắn:

1. POST /api/v1/activations với phần thân {"service": "<id>", "country": "ee"}. Phản hồi chứa một id kích hoạt và số +372 để nhập vào biểu mẫu đăng ký hoặc đăng nhập đang được kiểm thử.
2. Kích hoạt SMS xác minh từ ứng dụng bạn đang thử.
3. Chờ mã. Endpoint của bạn nhận activation.sms_received, hoặc bạn gọi GET /api/v1/activations/{id} theo một khoảng cách hợp lý.
4. Nhập mã vào ứng dụng và ghi lại kết quả theo id kích hoạt.
5. Nếu luồng kiểm thử thay đổi và không còn cần số nữa, hãy gọi POST /api/v1/activations/{id}/cancel để khoản giữ được giải phóng ngay.

Với các lần gửi webhook, hãy đọc header X-OTPRoute-Signature (t=<unix>,v1=<hex>), tính HMAC-SHA256 trên <t>.<raw body> bằng khóa bí mật của endpoint, so sánh theo thời gian không đổi, và bỏ mọi thứ có dấu thời gian cũ. Bảo mật webhook OTP bằng HMAC trình bày một trình xử lý tham chiếu. Hãy làm cho thao tác ghi có tính idempotent theo id kích hoạt, vì một lần thử lại có thể giao cùng một sự kiện hai lần.

Những dịch vụ nào có thể gửi mã đến số xác minh Estonia?

Ảnh chụp trực tiếp của Estonia liệt kê hơn 1,700 dịch vụ. Các tuyến phổ biến gồm WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, LinkedIn, Microsoft & Outlook, Amazon, Discord, Signal, Uber, Airbnb và ChatGPT (OpenAI).

Kho số thay đổi suốt ngày, nên một tuyến còn trả lời sáng nay có thể đã cạn vào buổi tối. Hãy coi GET /api/v1/countries và endpoint giá là nguồn đáng tin, thay vì gắn cứng một danh sách vào dữ liệu mẫu của bộ kiểm thử.

Nên lưu và kiểm tra số +372 như thế nào?

Estonia là một trong những kế hoạch đánh số đơn giản nhất để xử lý, và chính vì thế các bộ kiểm tra cẩu thả hay hỏng ở đây. Không có tiền tố nội hạt để bỏ đi: số viết theo kiểu trong nước chính là các chữ số bạn nối vào sau +372. Số di động thường bắt đầu bằng 5 và dài bảy hoặc tám chữ số, nên một regex bắt buộc độ dài quốc gia cố định sẽ từ chối các đầu vào hợp lệ.

Các quy tắc thực tế cho biểu mẫu và cơ sở dữ liệu của bạn:

• Lưu chuỗi E.164 đầy đủ, chẳng hạn +3725xxxxxxx, và giữ riêng dữ liệu người dùng nhập thô nếu cần cho hỗ trợ.
• Không bao giờ thêm số 0 ở đầu; không có gì để bỏ đi hay thêm vào.
• Hãy thử cả độ dài di động bảy chữ số và tám chữ số trong mặt nạ nhập liệu.

Tin nhắn xác minh gửi đến người dùng Estonia thường đến bằng tiếng Estonia, dù nhiều ứng dụng theo ngôn ngữ của tài khoản hoặc thiết bị, và mẫu tiếng Nga hay tiếng Anh cũng khá phổ biến. Nếu sản phẩm của bạn có bản địa hóa tiếng Estonia, hãy kiểm tra các chữ cái như õ, ä, ö và ü có còn nguyên vẹn từ mẫu đến điện thoại hay không.

Vì sao các đội thử luồng đăng ký trên số Estonia?

Estonia có tiếng nói vượt xa quy mô của mình trong giới làm phần mềm. Danh tiếng chính phủ số và chương trình e-Residency khiến nhiều nhà sáng lập và công ty làm việc từ xa có liên hệ với đất nước này dù nhân sự sống ở nơi khác, và các sản phẩm nhắm đến khu vực Baltic và Bắc Âu thường ra mắt ở đó trước.

Những lý do thường gặp khiến một trưởng nhóm QA yêu cầu số +372 để kiểm thử:

• Xác nhận bộ chọn quốc gia, mặt nạ số điện thoại và mẫu SMS hoạt động đúng với một thị trường EU có kế hoạch đánh số ngắn.
• Kiểm tra bản địa hóa nội dung tiếng Estonia trước một đợt phát hành khu vực.
• Tái hiện một phiếu hỗ trợ từ khách hàng Estonia mà mã không bao giờ đến.

Xem kiểm thử QA để biết các đội đưa những bước kiểm tra này vào chu kỳ phát hành ra sao.

Tôi nên kiểm tra gì khi mã không bao giờ xuất hiện?

Hãy xử lý vấn đề theo thứ tự thay vì đặt hết số này đến số khác:

1. Để khung thời gian chạy hết. Lượt kích hoạt mở trong 20 phút, và một số dịch vụ xếp hàng chờ tin nhắn.
2. Xác nhận dịch vụ có nhận số ảo. Một số dịch vụ từ chối theo chính sách; đó là lý do có cơ chế hoàn tiền.
3. Xem trạng thái cuối cùng. Sự kiện activation.expired, hoặc trạng thái hết hạn từ lệnh GET, nghĩa là không có SMS nào đến và tiền đã về ví.
4. Thử lại kiên nhẫn. Thử lại sau một lúc, hoặc thử tuyến khác cho cùng dịch vụ, thay vì đặt lại liên tục trong vòng lặp ngắn.
5. Kiểm tra chính bước kích hoạt của bạn. Một bài kiểm thử chưa thực sự yêu cầu gửi SMS trông giống hệt trường hợp mã bị mất.

Bài viết của chúng tôi về giảm số lần giao OTP thất bại liệt kê thêm các nguyên nhân cần loại trừ.

Tôi có thể giữ một số Estonia lâu dài không, và thanh toán hoạt động thế nào?

Không có số Estonia dài hạn tự phục vụ. Dedicated Number là sản phẩm chỉ có ở Mỹ và Canada, từ $1.95/month; với Estonia, hãy gửi email đến [email protected] nếu nhóm bạn cần một đường dây cố định, và đội ngũ sẽ cho bạn biết quy định địa phương cho phép những gì, không hứa trước về khả năng cung cấp.

Việc thanh toán cho OTP routing đi qua 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 bằng USDT hay USDC, và mỗi lần nạp tạo một hóa đơn PDF gửi qua email. Mức giá hiện hành nằm ở trang bảng giá, còn tài liệu tham chiếu endpoint nằm ở tài liệu.

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

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

Có. Hãy đặt một số +372 qua OTP Gateway, dùng nó trong biểu mẫu đăng ký và đọc mã từ dashboard, webhook hoặc endpoint kích hoạt.

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

Dùng ee làm giá trị country trong các yêu cầu kích hoạt và giá.

Số điện thoại Estonia có tiền tố nội hạt mà tôi cần bỏ đi không?

Không. Estonia không có tiền tố nội hạt, nên các chữ số trong nước đi ngay sau +372 mà không đổi.

Tôi có bị tính phí khi mã Estonia không đến không?

Không. Nếu không có gì đến trong khung 20 phút, hoặc bạn hủy trước đó, toàn bộ số tiền sẽ tự động quay về ví của bạn.

Người không phải lập trình viên có thể đặt số xác minh Estonia không?

Có. Trong dashboard, chọn Estonia và dịch vụ, xác nhận giá hiển thị, sao chép số vào ứng dụng rồi chờ mã hiện ra trên cùng màn hình.

Có thể diễn tập tích hợp Estonia trước khi tiêu tiền thật không?

Hãy nhờ bộ phận hỗ trợ chuyển tài khoản phát triển của bạn sang sandbox, trả về số và mã mô phỏng để toàn bộ luồng chạy được mà không dùng tiền trong ví.

Những quy tắc nào áp dụng cho cách tôi dùng các số này?

Hãy 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 OTP Route; các số này dành cho việc thử nghiệm và vận hành sản phẩm và tài khoản hợp pháp của chính bạ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.