Xác thực và endpoint tài khoản

Mỗi yêu cầu đều gửi kèm một header. Gọi GET /account để kiểm tra khóa có hoạt động không, xem số dư ví dùng để thanh toán đơn hàng và xác nhận tài khoản đã được kích hoạt trước khi chạy hàng loạt đơn.

Cách xác thực yêu cầu

Header Authorization chứa thông tin xác thực Bearer, gồm key ID và secret nối với nhau bằng dấu chấm. Key ID xác định tài khoản, còn secret được kiểm tra bằng phép so sánh HMAC. Nếu kiểm tra thất bại, API trả về 401 với MISSING_API_KEY hoặc INVALID_API_KEY trước khi route được xử lý. Ngoài ra không có gì khác bị kiểm tra: không cookie, không CSRF token, không header origin.

Danh sách IP được phép

Mỗi khóa có thể gắn với một nhóm địa chỉ nguồn cố định. Khi danh sách này có ít nhất một địa chỉ, yêu cầu từ mọi địa chỉ khác sẽ bị từ chối với IP_NOT_ALLOWED và HTTP 403, trước cả bước giới hạn tần suất và trước mọi lần tra cứu ví. Nhờ vậy, thông tin xác thực bị đánh cắp cũng không dùng được bên ngoài hạ tầng của bạn. Để trống danh sách nghĩa là khóa dùng được từ bất kỳ đâu.

Trạng thái tài khoản

Có một trạng thái ở cấp tài khoản chặn ngay mọi endpoint: tài khoản bị đóng băng sẽ nhận ACCOUNT_FROZEN với HTTP 403. Trạng thái này không tự hết, nên hãy báo cho nhân viên hỗ trợ thay vì gọi lại liên tục.

Đổi khóa định kỳ

Bạn tạo và xóa khóa tại trang API Access trong bảng điều khiển đại lý. Secret chỉ hiện một lần khi tạo, nên đổi khóa nghĩa là tạo khóa mới, triển khai, rồi xóa khóa cũ, không sửa trực tiếp được. Thông tin xác thực không tự hết hạn, vì vậy lịch đổi khóa do bạn tự đặt.

GET

/account

Lấy thông tin tài khoản

Trả về thông tin chi tiết của tài khoản, gồm số dư ví, trạng thái tài khoản và ngày tạo.

Giới hạn tần suất60 yêu cầu / 60 giây mỗi tài khoản

Yêu cầu

curl -s "https://shop2topup.com/api/endpoints/v1/account" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"

Phản hồi mẫu

{
  "success": true,
  "account": {
    "id": 42,
    "email": "[email protected]",
    "username": "partner_store",
    "client_type": "reseller",
    "wallet": "1250.500000",
    "enabled": true,
    "verified": true,
    "created_at": "2024-01-15T10:30:00Z"
  }
}

Gửi yêu cầu thật ngay trên trang này

Dán khóa API để gọi trực tiếp các endpoint này. Khóa chỉ nằm trong tab trình duyệt này và chỉ được gửi tới chính API.

Enter your API key to use the interactive playground. Get your API key

Chọn endpoint

Enter your API key above to try this endpoint.

Response will appear here after sending a request.

Nếu bạn mới dùng nền tảng, hãy bắt đầu với trang tổng quan API nạp game dành cho đại lý, hoặc đọc tổng quan chương trình đại lý SHOP2TOPUP để biết tài khoản đối tác hoạt động ra sao.