Thử tích hợp API không mất tiền: sandbox của sPortal

Mục lục 1. Vì sao nên thử trước khi tích hợp API? 2. Sandbox của sPortal hoạt động thế nào? 3. Ví thử 1.000.000 đ: mua, gia hạn, nâng cấp như thật 4. Thử cả những tình huống hiếm gặp 5. Kiểm tra chữ ký và webhook 6. Một lượt thử hoàn chỉnh 7. Giới hạn cần biết 8. Câu hỏi thường gặp

1. Vì sao nên thử trước khi tích hợp API?

Bài Tích hợp API sPortal: tự quản lý VPS, Proxy trên dashboard hoặc hệ thống riêng đã giới thiệu API làm được gì và cách bắt đầu. Khi bắt tay vào kết nối, đội kỹ thuật thường vướng ba chỗ:

• Ký request sai nên mọi lần gọi đều bị từ chối, mà không biết sai ở đâu.
• Xử lý webhook chưa đúng: máy chủ không nhận được thông báo, hoặc nhận rồi nhưng không kiểm chữ ký.
• Chưa lường hết tình huống: ví hết tiền, dịch vụ tạo lỗi, dịch vụ hết hạn, đơn bị hoàn tiền.

Nếu chỉ có môi trường thật, muốn thử những việc này phải nạp tiền thật và tạo dịch vụ thật. Sandbox giải quyết đúng chỗ đó.

2. Sandbox của sPortal hoạt động thế nào?

Sau khi đại lý duyệt hồ sơ tích hợp API, Quý khách hàng tạo được khóa thử (bắt đầu bằng ak_test_) bên cạnh khóa thật. Khóa quyết định chế độ: khóa thử chỉ đi vào môi trường thử, khóa thật chỉ đi vào môi trường thật, không có tham số nào đổi được chế độ.

• Giống hệt bản thật: cùng địa chỉ API, cùng cách ký request, cùng mã lỗi, cùng cách tính giá. Sản phẩm và giá lấy đúng theo nhóm giá đại lý áp cho Quý khách hàng.
• Tách riêng hoàn toàn: khóa thử không thấy và không chạm được Ví API, đơn hàng, dịch vụ, hóa đơn thật. Dữ liệu thử cũng không lẫn vào báo cáo, doanh thu hay việc tự gia hạn thật.
• Không cần bật thêm: mọi khách đã được duyệt API đều dùng được, đại lý không phải bật riêng.

Phần mềm chạy đúng với khóa thử thì chỉ cần đổi sang khóa thật là chạy được.

3. Ví thử 1.000.000 đ: mua, gia hạn, nâng cấp như thật

Lần đầu dùng khóa thử, Quý khách hàng có sẵn ví thử 1.000.000 đ. Mọi giao dịch qua khóa thử đều trừ vào ví này:

• Mua mới: đơn thử được tính giá như thật và trừ ví thử. Dịch vụ thử chuyển từ đang tạo sang đang hoạt động trong khoảng một phút, có IP mẫu, kèm webhook đơn đã thanh toán và dịch vụ đã kích hoạt.
• Gia hạn, nâng cấp: tính tiền như thật, nâng cấp theo số ngày còn lại của chu kỳ.
• Thao tác dịch vụ: bật, tắt, khởi động lại, cài lại hệ điều hành, đổi IP; bật hoặc tắt tự gia hạn.
• Nạp ví thử: phần mềm tạo lệnh nạp như thật; Quý khách hàng bấm duyệt trên trang để giả lập đã nhận tiền.

Quý khách hàng tự đặt lại số dư ví thử bất cứ lúc nào, ví dụ đặt về 0 để xem phần mềm xử lý lỗi thiếu số dư ra sao.

Cần ước lượng thời gian tích hợp cho hệ thống của mình? Liên hệ Sale hoặc chat với chúng tôi để được tư vấn.

4. Thử cả những tình huống hiếm gặp

Ngoài luồng bình thường, khóa thử còn gọi được các API giả lập riêng, để phần mềm được kiểm cả những ca khó tái hiện trên môi trường thật:

• Dịch vụ tạo lỗi: kiểm phần mềm báo lỗi cho khách và xử lý đơn thế nào.
• Dịch vụ sắp hết hạn, đã hết hạn, gia hạn lỗi: kiểm luồng nhắc gia hạn và tự gia hạn.
• Hoàn tiền đơn: giả lập đại lý hoàn đơn, ví thử được cộng lại và có webhook báo về.
• Ví thiếu tiền: đơn không được tạo, API trả lỗi thiếu số dư.

Các API giả lập chỉ tồn tại với khóa thử; khóa thật gọi vào sẽ không tìm thấy.

5. Kiểm tra chữ ký và webhook

Kiểm tra chữ ký. Đội kỹ thuật gửi một request y như thật tới đường dẫn kiểm tra chữ ký. Hệ thống trả lại chữ ký có khớp hay không, chuỗi dữ liệu máy chủ đã dùng để ký, mã băm của nội dung nhận được và gợi ý chỗ lệch, để đội kỹ thuật tự so với bên mình. Vì an toàn, hệ thống không bao giờ trả về chữ ký đúng.

Gửi thử webhook. Chọn một loại sự kiện (kiểm kết nối, đơn đã thanh toán, dịch vụ đã kích hoạt, ví sắp hết tiền, ...) rồi bấm gửi thử; kết quả máy chủ có nhận được hay không hiện ngay trên trang. Webhook phát sinh từ dữ liệu thử cũng được gửi thật tới địa chỉ nhận của Quý khách hàng, có đánh dấu chế độ thử để phân biệt với thông báo thật.

Mọi lần gọi bằng khóa thử đều nằm trong nhật ký gọi API thử riêng, cách đọc giống nhật ký thật.

6. Một lượt thử hoàn chỉnh

1. Tạo khóa thử trên trang Môi trường thử nghiệm, cấu hình vào phần mềm, gọi các API chỉ đọc (tài khoản, số dư, sản phẩm).
2. Mua thử một dịch vụ, xem đơn, dịch vụ và số dư ví thử thay đổi đúng.
3. Đặt ví thử về 0 rồi mua tiếp để chắc phần mềm báo lỗi thiếu tiền đúng cách; tạo lệnh nạp và duyệt để ví có tiền lại.
4. Gửi thử webhook để kiểm máy chủ nhận thông báo và kiểm chữ ký.
5. Chuyển sang thật: tạo khóa thật, nạp tiền vào Ví API, thay cả Key ID lẫn Secret trong phần mềm.

Hướng dẫn chi tiết từng thao tác: Môi trường thử nghiệm, Tích hợp API và Ví API.

7. Giới hạn cần biết

• Dịch vụ thử là dữ liệu giả lập (IP mẫu, tài khoản mẫu), không đăng nhập hay kết nối được. Cần kiểm kết nối thật thì mua một dịch vụ thật với chu kỳ ngắn nhất.
• Dữ liệu thử tự xóa sau 7 ngày không dùng khóa thử; muốn làm lại từ đầu thì bấm xóa dữ liệu thử, ví thử về lại 1.000.000 đ.
• Mỗi loại khóa (thử, thật) có tối đa 2 khóa đang dùng. Secret chỉ hiện một lần khi tạo.

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

Thử trong sandbox có bị trừ tiền thật không? Không. Khóa thử chỉ dùng ví thử và chỉ tạo dữ liệu giả lập; Ví API, đơn hàng và dịch vụ thật không bị ảnh hưởng.

Đại lý có phải bật sandbox riêng không? Không. Mọi khách đã được đại lý duyệt hồ sơ tích hợp API đều dùng được môi trường thử. Khi quyền API bị tạm khóa, môi trường thử cũng tạm dừng.

Dữ liệu thử có lẫn vào báo cáo hay hóa đơn không? Không. Dữ liệu thử nằm riêng, không xuất hiện trong báo cáo, doanh thu, hóa đơn của Quý khách hàng hay của đại lý.

Phần mềm chạy tốt với khóa thử, chuyển sang thật cần đổi gì? Chỉ cần thay Key ID và Secret bằng khóa thật, nạp tiền vào Ví API. Địa chỉ API, cách ký và mã lỗi giữ nguyên.

Sẵn sàng thử tích hợp API không mất tiền? Liên hệ Sale hoặc chat với chúng tôi để được tư vấn.