📚 Tài liệu API

Hướng dẫn tích hợp đầy đủ với API ZerAcc. Tìm hiểu cách kiểm tra số dư, tạo đơn hàng và quản lý tài khoản theo chương trình.

Xác thực

Tất cả API requests đều yêu cầu xác thực bằng API key duy nhất của bạn. Bao gồm API key của bạn như một tham số truy vấn trong tất cả requests.

Định dạng phản hồi

Tất cả API responses đều tuân theo cấu trúc JSON thống nhất:

{
  "status": true,
  "message": "Success message",
  "data": {
    // Response data
  }
}

Lấy danh sách tất cả sản phẩm hoạt động với thông tin cơ bản. Endpoint này là public và không yêu cầu xác thực.

Tham số:

No parameters required

Phản hồi:

{
  "status": true,
  "message": "Products data retrieved successfully",
  "data": [
    {
      "id": 1,
      "name": "Premium Account",
      "price": 99.99,
      "in_stock": 150
    },
    {
      "id": 2,
      "name": "Basic Account", 
      "price": 49.99,
      "in_stock": 300
    }
  ]
}

Ví dụ:

Lấy số dư hiện tại của tài khoản bạn bằng USD.

Tham số:

api_key bắt buộc string - Your API key

Phản hồi:

{
  "status": true,
  "message": "Success",
  "data": {
    "balance": "$123.45"
  }
}

Ví dụ:

Tạo đơn hàng sản phẩm mới. Đơn hàng sẽ được xử lý tự động nếu bạn có đủ tiền.

Tham số:

api_key bắt buộc string - Your API key

product_id bắt buộc integer - ID sản phẩm để đặt hàng

quantity bắt buộc integer - Số lượng items để đặt hàng

discount_code tùy chọn string - Mã giảm giá tùy chọn

Phản hồi:

{
  "status": true,
  "message": "Success",
  "data": {
    "order_id": "ORD123456"
  }
}

Ví dụ:

Lấy chi tiết đơn hàng và tải xuống items đã mua.

Tham số:

api_key bắt buộc string - Your API key

order_id bắt buộc string - Mã định danh duy nhất của đơn hàng

Phản hồi:

{
  "status": true,
  "message": "Success",
  "data": {
    "order_id": "ORD123456",
    "product_id": 1,
    "quantity": 1,
    "amount": 1,
    "status": "completed",
    "description": "",
    "format": "username:password",
    "created_at": "2023-12-01T10:30:00Z",
    "updated_at": "2023-12-01T10:35:00Z",
    "items": []
  }
}