Gọi tư vấn
Trang chủ Tính năng Làm đại lý Tích hợp API Tin tức Hướng dẫn Liên hệ

Môi trường thử nghiệm

Thử kết nối API bằng key thử nghiệm, ví thử và dịch vụ giả lập — không mất tiền thật.

Môi trường thử nghiệm giúp bạn (hoặc lập trình viên của bạn) kiểm tra phần mềm kết nối API trước khi chạy thật. Bạn dùng một API key thử nghiệm để gọi đúng các API như thật, nhưng tiền là ví thử, dịch vụ là dữ liệu giả lập - không mất tiền, không tạo VPS / Proxy thật. Mọi dữ liệu thử tách riêng hoàn toàn với Ví API, đơn hàng và dịch vụ thật của bạn.

Đường dẫn: Menu trái → Tích hợp API → nút Môi trường thử nghiệm (góc trên bên phải)

Trang này chỉ dùng được khi hồ sơ đăng ký API của bạn đã được duyệt (xem bài Tích hợp API). Khi quyền API đang bị tạm khóa, môi trường thử nghiệm cũng tạm dừng.

1. Tổng quan màn hình

Trang dùng tông màu cam và nhãn THỬ NGHIỆM để bạn luôn biết mình đang ở dữ liệu thử. Nút Về Tích hợp API ở góc trên bên phải đưa bạn quay lại trang dữ liệu thật.

  • Cột trái - Dữ liệu thử: số dư ví thử, số dịch vụ / đơn thử, các nút điều khiển ví thử, khối API key thử nghiệm và khối Gửi thử webhook.
  • Cột phải - 5 tab: Nhật ký gọi API thử, Webhook thử, Dịch vụ thử, Đơn thử, Nạp thử.
Màn hình Môi trường thử nghiệm API
Hình 1 - Màn hình Môi trường thử nghiệm API (dữ liệu minh họa, API key đã được làm mờ).

Một số điều cần biết về dữ liệu thử:

  • Gọi API bằng key thử dùng cùng địa chỉ API, cùng cách ký, cùng mã lỗi như key thật - phần mềm chạy được ở đây thì chỉ cần đổi sang key thật.
  • Dịch vụ thử chỉ là dữ liệu mẫu (IP dạng 203.0.113.x), không đăng nhập được.
  • Webhook vẫn được gửi thật tới Webhook URL của bạn, trong nội dung có "mode": "test" để phân biệt với thông báo thật.
  • Dữ liệu thử tự xóa sau một số ngày không dùng key thử (số ngày ghi ngay trên trang).
  • Link Tải tài liệu (PDF) trong khung mô tả tải cùng bộ tài liệu kỹ thuật như ở trang Tích hợp API.

2. Tạo API key thử nghiệm

Key thử nghiệm có Key ID bắt đầu bằng ak_test_, khác với key thật (tạo ở trang Tích hợp API). Hai loại key được đếm riêng, mỗi loại tối đa 2 key đang dùng.

  1. 1
    Ở khối API key thử nghiệm, bấm Tạo key.
  2. 2
    Đặt Tên gợi nhớ (ví dụ Môi trường dev) rồi bấm Tạo key.
  3. 3
    Sao chép Key ID và Secret, tích ô xác nhận đã lưu rồi bấm Xác nhận và đóng. Secret chỉ hiện 1 lần, giống key thật.

Cách xem, sao chép và Thu hồi key thử giống hệt key thật - xem chi tiết ở bài Tích hợp API, mục 6. Nếu khối này nhắc đồng ý Điều khoản, hãy đồng ý ở trang Tích hợp API trước.

Đừng để nhầm key: key ak_test_ chỉ tạo dữ liệu giả lập, key thật mới tạo dịch vụ và trừ tiền thật. Khi chuyển phần mềm sang chạy thật, nhớ thay cả Key ID lẫn Secret.

3. Điều khiển ví thử

Khung đầu tiên của cột trái hiện 3 ô: Ví thử (số dư), Dịch vụ và Đơn (số lượng - bấm vào số để mở tab danh sách tương ứng). Bên dưới là các nút giúp bạn tạo tình huống để thử:

Nút / ôDùng để làm gì
Đặt số dư ví thử (đ) + ĐặtGõ số tiền rồi bấm Đặt để đổi số dư ví thử ngay lập tức. Ví dụ đặt 0 để kiểm tra phần mềm của bạn xử lý lỗi thiếu tiền (INSUFFICIENT_BALANCE) thế nào.
Duyệt đơn nạp thử (n)Ở môi trường thử không có chuyển khoản thật. Sau khi phần mềm tạo đơn nạp bằng key thử, bấm nút này để giả lập "đã nhận tiền": tất cả đơn nạp thử đang chờ (còn hạn) được duyệt và cộng vào ví thử. Số trong ngoặc là số đơn đang chờ; bằng 0 thì nút bị mờ.
Xóa dữ liệu thửXóa toàn bộ đơn, dịch vụ và đơn nạp thử, đưa ví thử về số dư khởi tạo (ghi trong cửa sổ xác nhận). Dữ liệu thật không bị ảnh hưởng, key thử vẫn dùng được.

Xóa dữ liệu thử không hoàn tác được. Dùng khi bạn muốn làm lại từ đầu một lượt thử sạch sẽ.

Mẹo: ngoài các nút trên trang, key thử còn gọi được một số API giả lập riêng - ví dụ duyệt một đơn nạp, giả lập dịch vụ tạo lỗi / sắp hết hạn / hết hạn / gia hạn lỗi, hoàn tiền một đơn thử - để bạn kiểm tra các tình huống hiếm gặp. Chi tiết xem trong tài liệu PDF, phần Môi trường thử nghiệm.

4. Gửi thử webhook

Khối Gửi thử webhook giúp bạn kiểm tra máy chủ đã nhận được thông báo và kiểm tra chữ ký đúng chưa, mà không phải chờ sự kiện thật.

  1. 1
    Chọn loại sự kiện trong danh sách - ví dụ ping - kiểm kết nối, order.paid, service.activated, wallet.low_balance…
  2. 2
    Bấm Gửi thử. Hệ thống gửi một thông báo mẫu (có "mode": "test") tới Webhook URL của bạn.
  3. 3
    Xem kết quả ngay bên dưới: chữ xanh "✓ Nhận được (HTTP …, … ms)" là máy chủ đã nhận; chữ đỏ "✗ …" kèm nội dung lỗi là chưa nhận được. Sự kiện vừa gửi cũng hiện trong tab Webhook thử.

Chưa khai báo Webhook URL thì khối này chỉ hiện lời nhắc - hãy khai báo ở trang Tích hợp API (mục 7).

5. Xem kết quả thử ở các tab bên phải

  • Nhật ký gọi API thử - mọi yêu cầu gửi bằng key thử, cách đọc giống tab Nhật ký gọi API của key thật (thời gian, thao tác, kết quả / mã lỗi, đơn hàng, IP / key, thời gian xử lý).
  • Webhook thử - các thông báo tự động phát sinh từ dữ liệu thử và tình trạng gửi tới máy chủ của bạn.
  • Dịch vụ thử, Đơn thử, Nạp thử - danh sách tối đa 100 dòng mới nhất của từng loại dữ liệu thử. Nút ở góc phải tải lại danh sách.

Tab Dịch vụ thử

Tab Dịch vụ thử
Hình 2 - Tab Dịch vụ thử (dữ liệu minh họa).

Mỗi dòng gồm: Dịch vụ (tên sản phẩm và mã id dùng khi gọi API), Trạng thái, Kết nối (IP, cổng, tài khoản, hệ điều hành / vị trí / giao thức), Cấu hình (CPU, RAM, ổ đĩa, chu kỳ, có tự gia hạn hay không), Hạn dùng. Các trạng thái:

  • Đang hoạt động - dịch vụ thử đã "chạy".
  • Đang tạo / Đang cài lại OS / Đang đổi IP - đang xử lý một thao tác.
  • Hết hạn - đã quá hạn dùng.
  • Tạo lỗi - tạo không thành công; lý do hiện ngay dưới trạng thái.
  • Đã hủy - dịch vụ thử đã bị hủy.

Tab Đơn thử

Tab Đơn thử
Hình 3 - Tab Đơn thử (dữ liệu minh họa).
  • Mã đơn - kèm loại đơn: Mua mới, Gia hạn hoặc Nâng cấp.
  • Nội dung - sản phẩm trong đơn (hoặc id dịch vụ được gia hạn / nâng cấp). Dòng clientReference là mã tham chiếu phần mềm của bạn gửi kèm khi tạo đơn - giúp bạn đối chiếu đơn với hệ thống của mình.
  • Tổng tiền (đ) - số tiền trừ vào ví thử; có thể kèm dòng Giảm … hoặc Đã hoàn ….
  • Trạng thái - Đã thanh toán, Hoàn thành hoặc Đã hoàn tiền.

Tab Nạp thử

Tab Nạp thử
Hình 4 - Tab Nạp thử (dữ liệu minh họa).

Liệt kê các đơn nạp mà phần mềm của bạn tạo bằng key thử: Mã nạp, Số tiền (đ) (kèm VAT nếu có), Hóa đơn, Trạng thái, Thời gian tạo / duyệt.

  • Chờ chuyển khoản - đang chờ, kèm hạn. Bấm Duyệt đơn nạp thử ở cột trái để giả lập đã nhận tiền.
  • Đã duyệt - đã cộng vào ví thử, kèm thời điểm duyệt.
  • Hết hạn / Đã hủy - không còn hiệu lực.

6. Gợi ý một lượt thử hoàn chỉnh

  1. 1
    Tạo key thử, cấu hình vào phần mềm. Gọi thử các API chỉ đọc (xem tài khoản, số dư, danh sách sản phẩm) và kiểm tra tab Nhật ký gọi API thử đều báo thành công.
  2. 2
    Tạo một đơn mua bằng API → xem đơn ở tab Đơn thử, dịch vụ ở tab Dịch vụ thử, ví thử bị trừ tiền.
  3. 3
    Đặt ví thử về 0 rồi tạo thêm đơn để chắc phần mềm báo lỗi thiếu tiền đúng cách. Tạo đơn nạp bằng API, bấm Duyệt đơn nạp thử để ví có tiền trở lại.
  4. 4
    Dùng Gửi thử webhook để kiểm tra máy chủ nhận thông báo. Khi mọi thứ ổn, tạo key thật ở trang Tích hợp API, nạp Ví API và chuyển phần mềm sang key thật.

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

Thử nghiệm có bị trừ tiền thật không?

Không. Key ak_test_ 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 của bạn không bị ảnh hưởng.

Đăng nhập vào VPS thử được không?

Không. Dịch vụ thử chỉ là dữ liệu mẫu để phần mềm của bạn kiểm tra luồng mua / gia hạn / quản lý, không phải máy chủ thật.

Dữ liệu thử tự nhiên biến mất?

Dữ liệu thử được tự xóa sau một thời gian không dùng key thử (số ngày ghi trong khung mô tả ở cột trái). Key thử vẫn còn, bạn chỉ cần thử lại.

Trang báo "Môi trường thử nghiệm chỉ dùng được khi … đã duyệt đăng ký"?

Hồ sơ đăng ký API của bạn chưa được duyệt hoặc đang bị tạm khóa. Kiểm tra trạng thái ở trang Tích hợp API.

← Bài trước Ví API